localeconv

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

localeconv — Lit la configuration locale

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

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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

verdy_p at wanadoo dot fr ¶

24 years ago

The C99 standard modified slightly the definition of the international currency symbol, which is now 4 characters long instead of 3 in previous definitions. The fourth character will most often be an ASCII space, but its effective value is the locale-specific spacing character used for numeric grouping (i.e. the one refered by [sep_by_space] and [grouping])...

＋add a note