localeconv

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

localeconv — Obtém informação de formatação numérica

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

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

Example #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