Descrição

localeconv(): array

Retorna um array associativo contendo informação de formatação numérica e monetária de acordo com a localidade.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

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

0 - Parênteses envolvem a quantidade e o currency_symbol

1 - A string de sinal precede a quantidade e o currency_symbol

2 - A string de sinal sucede a quantidade e o currency_symbol

3 - A string de sinal precede imediatamente o currency_symbol

4 - A string de sinal sucede imediatamente o currency_symbol

n_sign_posn

0 - Parênteses envolvem a quantidade e o currency_symbol

1 - A string de sinal precede a quantidade e o currency_symbol

2 - A string de sinal sucede a quantidade e o currency_symbol

3 - A string de sinal precede imediatamente o currency_symbol

4 - A string de sinal sucede imediatamente o currency_symbol

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	0 - Parênteses envolvem a quantidade e o currency_symbol 1 - A string de sinal precede a quantidade e o currency_symbol 2 - A string de sinal sucede a quantidade e o currency_symbol 3 - A string de sinal precede imediatamente o currency_symbol 4 - A string de sinal sucede imediatamente o currency_symbol
n_sign_posn	0 - Parênteses envolvem a quantidade e o currency_symbol 1 - A string de sinal precede a quantidade e o currency_symbol 2 - A string de sinal sucede a quantidade e o currency_symbol 3 - A string de sinal precede imediatamente o currency_symbol 4 - A string de sinal sucede imediatamente o currency_symbol

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.

Exemplos

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
        )

)

Veja Também

setlocale() - Define informação de localidade