8.21.22 localeconv
[Notes en ligne] [Exemples]

Lit le formatage numérique et monétaire

array localeconv (void)
localeconv() retourne un tableau associatif contenant les informations locales de formats monétaire et numérique utilisés par le serveur.
localeconv() retourne les informations à partir des données locales, comme définies par setlocale(). Le tableau associatif retourné contient les entrées suivantes :

Index	Description
decimal_point	Séparateur décimal
thousands_sep	Séparateur de milliers
grouping	Tableau contenant les groupages numériques
int_curr_symbol	Symbole monétaire international (i.e. FRF)
currency_symbol	Symbole monétaire local (i.e. F)
mon_decimal_point	Séparateur décimal monétaire
mon_thousands_sep	Séparateur de milliers monétaires
mon_grouping	Tableau contenant les groupages numériques monétaires
positive_sign	Signe des valeurs positives
negative_sign	Signe des valeurs négatives
int_frac_digits	Nombre de chiffres décimaux international
frac_digits	Nombre de chiffres décimaux locaux
p_cs_precedes	TRUE si currency_symbol précède une valeur positive, FALSE s'il lui succède
p_sep_by_space	TRUE si un espace sépare currency_symbol d'une valeur positive, FALSE sinon
n_cs_precedes	TRUE si currency_symbol précède une valeur négative, FALSE s'il lui succède
n_sep_by_space	TRUE si un espace sépare currency_symbol d'une valeur négative, FALSE sinon
p_sign_posn	@itemize @bullet @item 0 @item Des parenthèses entourent la quantité et currency_symbol @item 1 @item Le signe précède la quantité et currency_symbol @item 2 @item Le signe suit la quantité et currency_symbol @item 3 @item Le signe précède immédiatement currency_symbol @item 4 @item Le signe suit immédiatement currency_symbol @end itemize
n_sign_posn	@itemize @bullet @item 0 @item Des parenthèses entourent la quantité et currency_symbol @item 1 @item Le signe précède la quantité et currency_symbol @item 2 @item Le signe suit la quantité et currency_symbol @item 3 @item Le signe précède immédiatement currency_symbol @item 4 @item Le signe suit immédiatement currency_symbol @end itemize

Le champs de groupage contient un tableau qui définit comment les chiffres doivent être regroupés. Par exemple, ce champs pour le dollar américain contient un tableau de deux éléments (3 et 3). Les éléments sont classés de gauche à droite. Si un des éléments vaut CHAR_MAX, les groupages ne sont plus effectués. Si un éléments vaut 0, la valeur du précédent doit être utilisée.

Exemple avec localeconv()

<?php
  setlocale(LC_ALL, "en_US");
  $locale_info = localeconv();
  echo "<PRE>\n";
  echo "--------------------------------------------\n";
  echo "  Informations monétaires pour le serveur local: \n";
  echo "--------------------------------------------\n\n";
  echo "int_curr_symbol:   {$locale_info["int_curr_symbol"]}\n";
  echo "currency_symbol:   {$locale_info["currency_symbol"]}\n";
  echo "mon_decimal_point: {$locale_info["mon_decimal_point"]}\n";
  echo "mon_thousands_sep: {$locale_info["mon_thousands_sep"]}\n";
  echo "positive_sign:     {$locale_info["positive_sign"]}\n";
  echo "negative_sign:     {$locale_info["negative_sign"]}\n";
  echo "int_frac_digits:   {$locale_info["int_frac_digits"]}\n";
  echo "frac_digits:       {$locale_info["frac_digits"]}\n";
  echo "p_cs_precedes:     {$locale_info["p_cs_precedes"]}\n";
  echo "p_sep_by_space:    {$locale_info["p_sep_by_space"]}\n";
  echo "n_cs_precedes:     {$locale_info["n_cs_precedes"]}\n";
  echo "n_sep_by_space:    {$locale_info["n_sep_by_space"]}\n";
  echo "p_sign_posn:       {$locale_info["p_sign_posn"]}\n";
  echo "n_sign_posn:       {$locale_info["n_sign_posn"]}\n";
  echo "</PRE>\n";
?>
    

La constante CHAR_MAX est aussi définie ci-dessus.

Note : Ajouté en PHP 4.0.5
Voir aussi setlocale().