Description

localeconv(): array

Retourne un tableau associatif contenant les informations de formats localisées pour les nombres et la monnaie.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

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 tableau Description

decimal_point Séparateur décimal

thousands_sep Séparateur de milliers

grouping Tableau contenant les regroupements numériques

int_curr_symbol Symbole monétaire international (c.-à-d. EUR)

currency_symbol Symbole monétaire local (c.-à-d. ¤)

mon_decimal_point Séparateur décimal monétaire

mon_thousands_sep Séparateur de milliers monétaires

mon_grouping Tableau contenant les regroupements numériques monétaires

positive_sign Signe des valeurs positives

negative_sign Signe des valeurs négatives

int_frac_digits Nombre international de décimales

frac_digits Nombre local de décimales

p_cs_precedes true si 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

Index du tableau	Description
decimal_point	Séparateur décimal
thousands_sep	Séparateur de milliers
grouping	Tableau contenant les regroupements numériques
int_curr_symbol	Symbole monétaire international (c.-à-d. EUR)
currency_symbol	Symbole monétaire local (c.-à-d. ¤)
mon_decimal_point	Séparateur décimal monétaire
mon_thousands_sep	Séparateur de milliers monétaires
mon_grouping	Tableau contenant les regroupements numériques monétaires
positive_sign	Signe des valeurs positives
negative_sign	Signe des valeurs négatives
int_frac_digits	Nombre international de décimales
frac_digits	Nombre local de décimales
p_cs_precedes	`true` si 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 p_sign_posn et n_sign_posn contiennent une chaîne formaté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 0, l'élément précédent doit être utilisé.

Exemples

Exemple #1 Exemple avec localeconv()

<?php
if (false !== setlocale(LC_ALL, 'nl_NL.UTF-8@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] => 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
        )

)

Voir aussi

setlocale() - Modifie les informations de localisation