setlocale

setlocale

7.102 Chaînes de caractères (Strings)
7 Index des fonctions
Manuel PHP

. Introduction
. Pré-requis
. Installation
. Constantes prédefinies
. Voir aussi
. addcslashes
. addslashes
. bin2hex
. chop
. chr
. chunk_split
. convert_cyr_string
. count_chars
. crc32
. crypt
. echo
. explode
. fprintf
. get_html_translation_table
. hebrev
. hebrevc
. html_entity_decode
. htmlentities
. htmlspecialchars
. implode
. join
. levenshtein
. localeconv
. ltrim
. md5_file
. md5
. metaphone
. money_format
. nl_langinfo
. nl2br
. number_format
. ord
. parse_str
. print
. printf
. quoted_printable_decode
. quotemeta
. rtrim
->setlocale
. sha1_file
. sha1
. similar_text
. soundex
. sprintf
. sscanf
. str_ireplace
. str_pad
. str_repeat
. str_replace
. str_rot13
. str_shuffle
. str_split
. str_word_count
. strcasecmp
. strchr
. strcmp
. strcoll
. strcspn
. strip_tags
. stripcslashes
. stripos
. stripslashes
. stristr
. strlen
. strnatcasecmp
. strnatcmp
. strncasecmp
. strncmp
. strpos
. strrchr
. strrev
. strripos
. strrpos
. strspn
. strstr
. strtok
. strtolower
. strtoupper
. strtr
. substr_count
. substr_replace
. substr
. trim
. ucfirst
. ucwords
. vprintf
. vsprintf
. wordwrap

7.102.44 setlocale()Modifie les informations de localisation

[ Exemples avec setlocale ] PHP 3, PHP 4

string setlocale ( mixed category , string locale , string ... ) string setlocale ( mixed category , array locale )

setlocale retourne la nouvelle configuration locale, ou FALSE si la localisation n'est pas implémentée sur votre plate-forme, si la variable de localisation n'existe pas, ou si la catégorie spécifiée n'est pas valide. Un nom de catégorie invalide générera un message d'alerte.

category est une constante (ou une chaîne) qui spécifie la catégorie de fonction affectées par la configuration de localisation :

LC_ALL pour toutes les constantes suivantes
LC_COLLATE pour la comparaison de chaînes de caractères. Voir strcoll
LC_CTYPE pour la classification et la conversion de caractères. Voir strtoupper
LC_MONETARY pour localeconv
LC_NUMERIC pour le spéarateur décimal. Voir localeconv
LC_TIME pour le format de date et d'heure avec strftime

Si locale est la chaîne vide "" , les noms de locales seront pris dans l'environnement, à partir des variables de même noms que les catégories ci-dessus, ou depuis "LANG".

Si locale est NULL ou vaut "0" , la configuration locale ne sera pas modifiée, et la configuration courante sera retournée.

Note

La possibilité de passer plusieurs locales est disponible depuis PHP 4.3.0.

setlocale retourne la valeur de la locale courante, ou bien FALSE si la fonctionnalité de localisation n'est pas implémentée sur votre plate-forme, si la locale spécifiée n'existe pas, ou si la catégorie n'existe pas. Une catégorie invalide causera aussi l'affichage d'un message d'alerte.

Si locale vaut zéro ou "0" , la configuration de localisation ne sera pas modifiée, et seule la valeur courante sera retournée.

Note

Passer plusieurs locales n'était pas disponible avant PHP 4.3.0.

setlocale retourne la nouvelle valeur locale, ou bien FALSE si la fonctionnalité n'est pas implantée sur votre plate forme, que la configuration spécifiée n'existe pas ou que le nom de catégorie est invalide. Un nom de catégorie invalide causera aussi l'affichage d'une alerte. Les noms de catégories et de configurations locales sont disponibles dans la RFC 1766 et ISO 639 .

Note

La valeur retournée par setlocale dépend du système d'explotiation qui fait tourner PHP . La valeur retournée est exactement celle que la fonction setlocale() du système retourne.

Array

Exemple avec setlocale

<?php /* Configure le script en hollandais */ setlocale (LC_ALL, 'nl_NL'); /* Affiche : vrijdag 22 december 1978 */ echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); /* Essai de différentes valeurs possible pour l'allemand depuis <TT>PHP</TT> 4.3.0 */ $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); echo "L'identifiant de l'allemand sur ce système est '$loc_de'"; ?>

Exemple avec setlocale pour Windows

<?php /* Configure le script en hollandais */ setlocale (LC_ALL, 'nld_nld'); /* Affiche : vrijdag 22 december 1978 */ echo strftime ("%A %d %B %Y", mktime (0, 0, 0, 12, 22, 1978)); /* Essai de différentes valeurs possible pour l'allemand depuis <TT>PHP</TT> 4.3.0 */ $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'deu_deu'); echo "L'identifiant de l'allemand sur ce système est '$loc_de'"; ?>

<<	setlocale	>>
rtrim	Chaînes de caractères (Strings)	sha1_file