Manual do PHP
Anterior |  | Próxima

# localeconv

(PHP 4 >= 4.0.5, PHP 5)

localeconv -- Obté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().

Anterior | Principal | Próxima
levenshtein | Acima | ltrim