(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
localeconv — Obtener información sobre el formato numérico
Devuelve una matriz asociativa que contiene información de los formatos numérico y monetario, localizados.
localeconv() devuelve información basada en la localidad actual, tal y como haya sido definida mediante setlocale(). La matriz asociativa que devuelve contiene los siguientes campos:
| Elemento de la matriz | Descripción |
|---|---|
| decimal_point | Caracter de punto decimal |
| thousands_sep | Separador de miles |
| grouping | Matriz que contiene agrupaciones numéricas |
| int_curr_symbol | Símbolo internacional de moneda (i.e. USD) |
| currency_symbol | Símbolo local de moneda (i.e. $) |
| mon_decimal_point | Caracter de punto decimal monetario |
| mon_thousands_sep | Separador de miles monetario |
| mon_grouping | Matriz que contiene agrupaciones de moneda |
| positive_sign | Signo para valores positivos |
| negative_sign | Signo para valores negativos |
| int_frac_digits | Dígitos fraccionarios internacionales |
| frac_digits | Dígitos fraccionarios locales |
| p_cs_precedes |
true si currency_symbol precede un valor positivo, false
si lo sucede
|
| p_sep_by_space |
true si un espacio separa currency_symbol de un valor positivo,
false de lo contrario
|
| n_cs_precedes |
true si currency_symbol precede un valor negativo, false
si lo sucede
|
| n_sep_by_space |
true si un espacio separa currency_symbol de un valor
negativo, false de lo contrario
|
| p_sign_posn |
|
| n_sign_posn |
|
Los valores de p_sign_posn y
n_sign_posn contienen una cadena de opciones de
formato. Cada número representa una de las condiciones listadas
anteriormente.
Los campos de agrupamiento contienen matrices que definen el modo en que
los números deben ser agrupados. Por ejemplo, el campo de agrupamiento
monetario para la localidad nl_NL (en modo UTF-8 con el signo de euro),
tendría una matriz de 2 elementos con los valores 3 y 3. Entre más alto
sea el índice dentro de la matriz, lo más lejos hacia la izquierda se
encuentra el agrupamiento. Si un elemento de la matriz es igual a
CHAR_MAX, no se realiza ningún agrupamiento
posterior. Si un elemento de la matriz es igual a 0, el elemento anterior
deberá ser usado.
Ejemplo #1 Ejemplo de localeconv()
<?php
if (false !== setlocale(LC_ALL, 'nl_NL.UTF-8@euro')) {
$info_localidad = localeconv();
print_r($info_localidad);
}
?>El resultado del ejemplo sería:
Array
(
[decimal_point] => .
[thousands_sep] =>
[int_curr_symbol] => EUR
[currency_symbol] => €
[mon_decimal_point] => ,
[mon_thousands_sep] =>
[positive_sign] =>
[negative_sign] => -
[int_frac_digits] => 2
[frac_digits] => 2
[p_cs_precedes] => 1
[p_sep_by_space] => 1
[n_cs_precedes] => 1
[n_sep_by_space] => 1
[p_sign_posn] => 1
[n_sign_posn] => 2
[grouping] => Array
(
)
[mon_grouping] => Array
(
[0] => 3
[1] => 3
)
)
The C99 standard modified slightly the definition of the international currency symbol, which is now 4 characters long instead of 3 in previous definitions. The fourth character will most often be an ASCII space, but its effective value is the locale-specific spacing character used for numeric grouping (i.e. the one refered by [sep_by_space] and [grouping])...