Function.localeconv
Aus PHP-Wiki
localeconv — Ermittelt die Formatierungsinformationen für Zahlen
Inhaltsverzeichnis |
Beschreibung
array localeconv ( void )
Gibt ein assoziatives Array zurück, das die lokalisierten Informationen
zur Formatierung von Zahlen und Geldbeträgen enthält.
Rückgabewerte
localeconv() gibt Daten basierend auf den aktuellen
Locale-Einstellungen, wie sie mittels setlocale()
festgelegt werden können, zurück. Das assoziative Array, das zurückgegeben
wird, enthält folgende Felder:
Arrayelement
Beschreibung
decimal_point
Dezimaltrennzeichen
thousands_sep
Tausendertrennzeichen
grouping
Array mit numerischen Gruppierungen
int_curr_symbol
Internationales Währungssymbol (i.e. USD)
currency_symbol
Lokales Währungssymbol (i.e. $)
mon_decimal_point
Dezimaltrennzeichen bei Geldbeträgen
mon_thousands_sep
Tausendertrennzeichen bei Geldbeträgen
mon_grouping
Array mit Geldbetragsgruppierungen
positive_sign
Vorzeichen für positive Werte
negative_sign
Vorzeichen für negative WerteS
int_frac_digits
Internationale Dezimalbrüche
frac_digits
Lokale Dezimalbrüche
p_cs_precedes
Ist TRUE, wenn das Währungssymbol einem positiver Wert voransteht,
oder FALSE, wenn es einem positiven Wert folgt.
p_sep_by_space
Ist TRUE, wenn ein Leerzeichen das Währungssymbol von einem positiven
Wert trennt, ansonsten FALSE.
n_cs_precedes
Ist TRUE, wenn das Währungssymbol einem negativer Wert voransteht,
oder FALSE, wenn es einem negativen Wert folgt.
n_sep_by_space
Ist TRUE, wenn ein Leerzeichen das Währungssymbol von einem negativen
Wert trennt, ansonsten FALSE.
p_sign_posn
0 - Klammern um Menge und Währungssymbol
1 - Das Vorzeichen steht vor Menge und Währungssymbol
2 - Das Vorzeichen steht hinter Menge und Währungssymbol
3 - Das Vorzeichen steht direkt vor Menge und Währungssymbol
4 - Das Vorzeichen steht direkt hinter Menge und Währungssymbol
n_sign_posn
0 - Klammern um Menge und Währungssymbol
1 - Das Vorzeichen steht vor Menge und Währungssymbol
2 - Das Vorzeichen steht hinter Menge und Währungssymbol
3 - Das Vorzeichen steht direkt vor Menge und Währungssymbol
4 - Das Vorzeichen steht direkt hinter Menge und Währungssymbol
p_sign_posn und n_sign_posn enthalten
einen String mit Formatierungsinformationen. Jeder Wert repräsentiert
eine der oben aufgeführten Bedingungen.
Die Gruppierungsfelder enthalten Arrays, die die Art und Weise definieren,
in der Zahlen gruppiert werden sollten. Beispielsweise würde das
Gruppierungsfeld für Geldbeträge unter einer nl_NL-Locale (im UTF-8-Modus
mit dem Euro-Zeichen) ein Array mit zwei Einträgen mit den Werten 3 und 3
enthalten. Je höher der Index im Array, desto weiter links wird gruppiert.
Wenn ein Arrayelement CHAR_MAX entspricht, wird keine
weitere Gruppierung angewendet. Ist ein Arrayelement gleich 0, sollte das
vorangegangene Element verwendet werden.
Beispiele
#1 localeconv()
<?php if (false !== setlocale(LC_ALL, 'nl_NL.UTF-8@euro')) { $locale_info = localeconv(); print_r($locale_info); } ?>
Das oben gezeigte Beispiel erzeugt folgende
Ausgabe: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 ) )