PHP Manual
String-Funktionen
Ermittelt die Formatierungsinformationen für Zahlen

localeconv

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

localeconv — Ermittelt die Formatierungsinformationen für Zahlen

Beschreibung

localeconv(): array

Gibt ein assoziatives Array zurück, das die lokalisierten Informationen zur Formatierung von Zahlen und Geldbeträgen enthält.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

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:

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	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

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
        )

)