PHP 5.6.0RC3 is available

localeconv

(PHP 4 >= 4.0.5, PHP 5)

localeconvObtém a informação da formatação numérica

Description

array localeconv ( void )

Retorna uma matriz associativa contendo informação de formatação numérica.

localeconv() retorna dados baseados na localidade corrente definida por setlocale(). A matriz associativa que é retornada contém os seguintes campos:

Array element Descrição
decimal_point Caracter de ponto decimal
thousands_sep Thousands separator
grouping Matriz contendo agrupamentos numéricos
int_curr_symbol International currency symbol (i.e. USD)
currency_symbol Simbolo da moeda local symbol (i.e. $)
mon_decimal_point Caractere monetário de ponto decimal
mon_thousands_sep Separador monetário de mil
mon_grouping Matriz contendo agrupamentos monetários
positive_sign Sinal para valores positivos
negative_sign Sinal para valores negativos
int_frac_digits Dígitos de fração Internacionais
frac_digits Dígitos de fração locais
p_cs_precedes TRUE Se o simbolo da moeda precede um valor positivo, FALSE se eles sucede um.
p_sep_by_space TRUE Se um espaço separa o simbolo da moeda de um valor positivo, FALSE caso contrário
n_cs_precedes TRUE Se o simbolo de moeda precede um valor negativo, FALSE se ele sucede
n_sep_by_space TRUE se um espaço separa o simbolo da moeda de um valor negativo, FALSE caso contrário
p_sign_posn
  • 0
  • Parênteses na quantidade e simbolo da moeda
  • 1
  • A string sinal precede a quantidade e o simbolo da moeda
  • 2
  • A string sinal sucede a quantidade e o simbolo da moeda
  • 3
  • A string sinal precede imediatamente o simbolo da moeda
  • 4
  • A string sinal sucede imediatamente o simbolo da moeda
n_sign_posn
  • 0
  • Parentêses na quantidade e simbolo da moeda
  • 1
  • A string sinal precede a quantidade e o simbolo da moeda
  • 2
  • A string sinal sucede a quantidade e o simbolo da moeda
  • 3
  • A string sinal precede imediatamente o simbolo da moeda
  • 4
  • A string sinal sucede imediatamente o simbolo da moeda

Os campos de agrupamento contém matrizes que definem o modo de como os números seriam agrupados. Por exemplo, o campo de agrupamento para a localidade en_US, conteria uma matriz de 2 itens com os valores 3 e 3. O mais alto índice na matriz, mais distante da esquerda do agrupamento está. Se um elemento da matriz é igual a CHAR_MAX, até aqui nenhum agrupamento é feito. Se um elemento de matriz é igual a 0, o prévio elemento seria usado.

Exemplo #1 localeconv() exemplo

<?php
setlocale
(LC_ALL"en_US");

$locale_info localeconv();

echo 
"<pre>\n";
echo 
"--------------------------------------------\n";
echo 
"  Monetary information for current locale:  \n";
echo 
"--------------------------------------------\n\n";

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

A constante CHAR_MAX também está definida para o uso mencionado acima.

Veja também setlocale().

add a note add a note

User Contributed Notes 2 notes

up
0
PixEye at bigfoot dot com
1 year ago
Instead of using the big function of my old previous post, it is simpler and cleaner to use number_format() and money_format(%n) built-in PHP functions.
up
0
verdy_p at wanadoo dot fr
13 years ago
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])...
To Top