localeconv

(PHP 4 >= 4.0.5)

localeconv -- Obtener información sobre el formato numérico

Descripción

array localeconv ( void )

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 matrizDescripción
decimal_pointCaracter de punto decimal
thousands_sepSeparador de miles
groupingMatriz que contiene agrupaciones numéricas
int_curr_symbolSímbolo internacional de moneda (i.e. USD)
currency_symbolSímbolo local de moneda (i.e. $)
mon_decimal_pointCaracter de punto decimal monetario
mon_thousands_sepSeparador de miles monetario
mon_groupingMatriz que contiene agrupaciones de moneda
positive_signSigno para valores positivos
negative_signSigno para valores negativos
int_frac_digitsDígitos fraccionarios internacionales
frac_digitsDí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

0 Paréntesis rodean la cantidad y currency_symbol
1 La cadena de signo precede la cantidad y currency_symbol
2 La cadena de signo sucede la cantidad y currency_symbol
3 La cadena de signo precede inmediatamente currency_symbol
4 La cadena de signo sucede inmediatamente currency_symbol

n_sign_posn

0 Paréntesis rodean la cantidad y currency_symbol
1 La cadena de signo precede la cantidad y currency_symbol
2 La cadena de signo sucede la cantidad y currency_symbol
3 La cadena de signo precede inmediatamente currency_symbol
4 La cadena de signo sucede inmediatamente currency_symbol

Los campos de agrupamiento contienen matrices que definen el modo en que los números deben ser agrupados. Por ejemplo, el campo de agrupamiento para la localidad en_US debería contener 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
setlocale
(LC_ALL, "en_US");

$info_locale = localeconv();

echo
"<pre>\n";
echo
"-------------------------------------------------\n";
echo
" Informaci&oacute;n monetaria para la localidad actual:  \n";
echo
"-------------------------------------------------\n\n";

echo
"int_curr_symbol:   {$info_locale["int_curr_symbol"]}\n";
echo
"currency_symbol:   {$info_locale["currency_symbol"]}\n";
echo
"mon_decimal_point: {$info_locale["mon_decimal_point"]}\n";
echo
"mon_thousands_sep: {$info_locale["mon_thousands_sep"]}\n";
echo
"positive_sign:     {$info_locale["positive_sign"]}\n";
echo
"negative_sign:     {$info_locale["negative_sign"]}\n";
echo
"int_frac_digits:   {$info_locale["int_frac_digits"]}\n";
echo
"frac_digits:       {$info_locale["frac_digits"]}\n";
echo
"p_cs_precedes:     {$info_locale["p_cs_precedes"]}\n";
echo
"p_sep_by_space:    {$info_locale["p_sep_by_space"]}\n";
echo
"n_cs_precedes:     {$info_locale["n_cs_precedes"]}\n";
echo
"n_sep_by_space:    {$info_locale["n_sep_by_space"]}\n";
echo
"p_sign_posn:       {$info_locale["p_sign_posn"]}\n";
echo
"n_sign_posn:       {$info_locale["n_sign_posn"]}\n";
echo
"</pre>\n";
?>

La constante CHAR_MAX también se define para el uso mencionado anteriormente.

Vea también setlocale().