Edit Report a Bug

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 (i.e. EUR)
`currency_symbol`	Symbole monétaire local (i.e. ¤)
`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 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 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

add a note

User Contributed Notes 1 note

down

verdy_p at wanadoo dot fr ¶

23 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