(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
localeconv — Ermittelt die Formatierungsinformationen für Zahlen
Gibt ein assoziatives Array zurück, das die lokalisierten Informationen zur Formatierung von Zahlen und Geldbeträgen enthält.
Diese Funktion besitzt keine Parameter.
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:
| Array-Element | 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 Werte |
| 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 |
|
| n_sign_posn |
|
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.
Beispiel #1 localeconv()-Beispiel
<?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
)
)
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])...