localeconv

Descrizione

array localeconv ( void )

La funzione restituisce un array associativo contenente le configurazioni locali per il formato numerico e monetario.

La funzione localeconv() restituisce i dati in base alle configurazioni locali come impostate da setlocale(). L'array associativo restituito contiene i seguenti campi:

Elemento Descrizione

decimal_point Carattere per il punto decimale

thousands_sep Separatore delle migliaia

grouping Array contenente i gruppi numerici

int_curr_symbol Simbolo internazionale della divisa (i.e. USD)

currency_symbol Simbolo della divisa locale (i.e. $)

mon_decimal_point Carattere per il punto decimale nella moneta

mon_thousands_sep Separatore delle migliaia nella moneta

mon_grouping Array contenente i gruppi monetari

positive_sign Segno per i valori positivi

negative_sign Segno per i valori negativi

int_frac_digits Numero di caratteri frazionali internazionali

frac_digits Numero di caratteri frazionali locali

p_cs_precedes TRUE se il simbolo della divisa precede i valori positivi, FALSE se segue tali valori

p_sep_by_space TRUE se uno spazio separa il simbolo della divisa dai valori positivi FALSE in caso contrario

n_cs_precedes TRUE se il simbolo della divisa precede i valori negativi, FALSE se segue tali valori

n_sep_by_space TRUE se uno spazio separa il simbolo della divisa dai valori negativi, FALSE in caso contrario

p_sign_posn

0	Parentesi attorno alla quantità ed al simbolo della divisa
1	Il segno precede la quantità ed al simbolo della divisa
2	Il segno segue la quantità ed al simbolo della divisa
3	Il segno precede immediatamente il simbolo della divisa
4	Il segno segue immediatamente il simbolo della divisa

n_sign_posn

0	Parentesi attorno alla quantità ed al simbolo della divisa
1	Il segno precede la quantità ed al simbolo della divisa
2	Il segno segue la quantità ed al simbolo della divisa
3	Il segno precede immediatamente il simbolo della divisa
4	Il segno segue immediatamente il simbolo della divisa

I campi di raggruppamento contengono matrici che definiscono il modo con cui i numeri dovrebbero essere raggruppati. Ad esempio, i campi di raggruppamento per il formato en_US, contengono due elementi con i valori 3 e 3. L'indice più alto indica quanto è distinta il gruppo di sinistra. Se un elemento della matrice è uguale a CHAR_MAX, non vi sono più gruppi. Se nella matrice vi è un elemento a 0, occorre utilizzare l'elemento precedente.

Esempio 1. Esempio di uso di localeconv()


<?php
setlocale(LC_ALL, "en_US");

$locale_info = localeconv();

echo "<pre>\n";
echo "--------------------------------------------\n";
echo "  Informazioni sulla configurazione monetaria 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";
?>

E' presente una costante, CHAR_MAX, per gli utilizzi descritti in precedenza.

Vedere anche setlocale().