(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
localeconv — Obtém informação de formatação numérica
Retorna um array associativo contendo informação de formatação numérica e monetária de acordo com a localidade.
Esta função não possui parâmetros.
localeconv() retorna dados com base na localidade atual definida por setlocale(). O array associativo retornado contém os seguintes campos:
| Elemento do array | Descrição |
|---|---|
| decimal_point | Caractere de separação decimal |
| thousands_sep | Caractere de separação de milhares |
| grouping | Array contendo agrupamentos numéricos |
| int_curr_symbol | Símbolo internacional da moeda (ex.: BRL) |
| currency_symbol | Símbolo local da moeda (ex.: R$) |
| mon_decimal_point | Caractere de separação de decimais da moeda |
| mon_thousands_sep | Caractere de separação de milhares da moeda |
| mon_grouping | Array contendo agrupamentos monetários |
| positive_sign | Sinal para valores positivos |
| negative_sign | Sinal para valores negativos |
| int_frac_digits | Dígitos fracionários internacionais |
| frac_digits | Dígitos fracionários locais |
| p_cs_precedes |
true se currency_symbol precede um valor positivo, false
se ele o sucede
|
| p_sep_by_space |
true se um espaço separa currency_symbol de um valor
positivo, false caso contrário
|
| n_cs_precedes |
true se currency_symbol precede um valor negativo, false
se ele o sucede
|
| n_sep_by_space |
true se um espaço separa currency_symbol de um valor
negativo, false caso contrário
|
| p_sign_posn |
|
| n_sign_posn |
|
O p_sign_posn e o n_sign_posn contêm uma string
se opções de formatação. Cada número representa uma das condições listadas acima.
Os campos de agrupamento contêm arrays que definem a maneira em que os números devem
ser agrupados. Por exemplo, o campo de agrupamento monetário para a localidade nl_NL (em
modo UTF-8 com o sinal do Euro), contêm um array de 2 itens com os
valores 3 e 3. Quanto maior o índice no array, mais a esquerda fica
o agrupamento. Se um elemento do array for igual a CHAR_MAX,
não são feitos mais agrupamentos. Se um elemento do array for igual a 0, o elemento
anterior deve ser usado.
Exemplo #1 Exemplo de localeconv()
<?php
if (false !== setlocale(LC_ALL, 'nl_NL.UTF-8@euro')) {
$locale_info = localeconv();
print_r($locale_info);
}
?>O exemplo acima produzirá:
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])...