International PHP Conference Berlin 2025

localeconv

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

localeconvLit 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

up
1
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])...
To Top