setlocale

Beschreibung

string setlocale ( mixed category, string locale [, string ...] )

string setlocale ( mixed category, array locale )

Category ist eine benannte Konstante (oder Zeichenkette), welche die Kategorie der von den lokalen Einstellungen betroffenen Funktionen spezifiziert:

• LC_ALL für alle folgenden Werte

• LC_COLLATE für String-Vergleiche, siehe strcoll()

• LC_CTYPE für Klassifizierung und Umwandlung von Zeichen, z.B. strtoupper()

• LC_MONETARY für localeconv()

• LC_NUMERIC für das Dezimal-Trennzeichen (Siehe auch localeconv())

• LC_TIME für Zeit und Datums-Formatierungen mittels strftime()

Ist locale als Leer-String definiert, also "", werden die Werte an Hand der entsprechenden Umgebungsvariablen gleichen Namens wie die obigen Kategorien, oder von "LANG" bestimmt.

Ist locale NULL oder "0", sind keine Einstellungen betroffen, und es wird die aktuelle Einstellung zurückgegeben.

Ist locale ein Array, oder folgen weitere Parameter, dann wird jedes Array Element bzw. jeder Parameter versucht zu stzen, bis es gelingt. Dies ist dann sinnvoll, wenn eine locale auf verschiedenen Systemen unter verschiedenen Namen bekannt ist, oder auch als Fallback für eine eventuell nicht vorhandene locale.

setlocale() gibt die neue Einstellung oder FALSE (wenn die locale-Funktionalität auf der System-Plattform nicht unterstützt wird oder der Kategorie-Wert ungültig ist) zurück. Ein ungültiger Kategorie-Name erzeugt auch noch eine Warnmeldung.

Beispiel 1. setlocale() Beispiele <?php /* locale auf Holland setzen */ setlocale (LC_ALL, 'nl_NL'); /* Ausgabe: vrijdag 22 december 1978 */ echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); /* versuche verschiedene mögliche locale Namen für Deutsch ab PHP 4.3.0 */ $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); echo "Preferred locale for german on this system is '$loc_de'"; ?>