localeconv

(PHP 4 >= 4.0.5, PHP 5)

localeconv -- Lit la configuration locale

Description

array localeconv ( void )

localeconv() retourne un tableau associatif contenant les informations de formats localisées pour les nombres et la monnaie.

localeconv() retourne les formats en fonction de la configuration effectuée avec setlocale(). Le tableau associatif qui est retourné contient les index suivants :

Index du tableauDescription
decimal_pointSéparateur décimal
thousands_sepSéparateur de milliers
groupingTableau contenant les regroupements numériques
int_curr_symbolSymbole monétaire international (i.e. EUR)
currency_symbolSymbole monétaire local (i.e. €)
mon_decimal_pointSéparateur décimal monétaire
mon_thousands_sepSéparateur de milliers monétaires
mon_groupingTableau contenant les regroupements numériques monétaires
positive_signSigne des valeurs positives
negative_signSigne des valeurs négatives
int_frac_digitsNombre international de décimales
frac_digitsNombre local de décimales
p_cs_precedes TRUE si le currency_symbol précède une valeur positive et FALSE s'il lui succède.
p_sep_by_space TRUE si un espace sépare currency_symbol d'une valeur positive, et FALSE sinon.
n_cs_precedes TRUE si currency_symbol précède une valeur négative, et FALSE s'il lui succède.
n_sep_by_space TRUE si un espace sépare currency_symbol d'une valeur négative, et FALSE sinon.
p_sign_posn

0 - Des parenthèses entourent la valeur et le symbole monétaire
1 - Le signe précède la valeur et le symbole monétaire
2 - Le signe suit la valeur et le symbole monétaire
3 - Le signe précède immédiatement la valeur et le symbole monétaire
4 - Le signe suit immédiatement la valeur et le symbole monétaire

n_sign_posn

0 - Des parenthèses entourent la valeur et le symbole monétaire
1 - Le signe précède la valeur et le symbole monétaire
2 - Le signe suit la valeur et le symbole monétaire
3 - Le signe précède immédiatement la valeur et le symbole monétaire
4 - Le signe suit immédiatement la valeur et le symbole monétaire

Les champs n_sign_posn et n_sign_posn contiennent une chaîne formattée d'options. Chaque nombre représente une des conditions listées ci-dessus.

Les champs de regroupements contiennent des tableaux qui définissent la manière dont les nombres doivent être regroupés. Par exemple, le champ de regroupement monétaire pour nl_NL (en mode UTF-8 avec le signe euro), contiendra deux éléments, avec les valeurs 3 et 3. Si un élément de tableau contient CHAR_MAX, aucun autre regroupement n'est fait. Si un élément de tableau contient 3, l'élément précédent doit être utilisé.

Exemple 1. Exemple avec localeconv()

<?php
if (false !== setlocale(LC_ALL, 'fr_FR@euro')) {
    
$locale_info = localeconv();
    
print_r($locale_info);
}
?>

L'exemple ci-dessus va afficher :

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] => 0
    [p_sep_by_space] => 1
    [n_cs_precedes] => 0
    [n_sep_by_space] => 1
    [p_sign_posn] => 1
    [n_sign_posn] => 1
    [grouping] => Array
        (
        )

    [mon_grouping] => Array
        (
            [0] => 3
            [1] => 3
        )

)

Voir aussi setlocale().