setlocale

(PHP 3, PHP 4, PHP 5)

setlocale -- Setzt lokale Informationen

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:

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.

Anmerkung: Das Übergeben von mehreren locales wird erst seit PHP 4.3 unterstützt.

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.

Anmerkung: Der Rückgabewert von setlocale() ist von dem System abhängig, auf dem PHP läuft. Es wird genau das zurückgegeben, was die Systemfunktion setlocale zurückgibt.

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'";
?>

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:57:22