Provided by:
manpages-fr-dev_3.32d0.2p4-1_all 
NOM
setlocale - Fixer la localisation courante
SYNOPSIS
#include <locale.h>
char *setlocale(int categorie, const char *locale);
DESCRIPTION
La fonction setlocale() est utilisee pour indiquer ou demander la
localisation courante du programme.
Si locale n'est pas NULL, la localisation courante du programme est
modifiee en fonction des arguments. L'argument categorie determine
quelle partie de la localisation sera concernee par la modification.
LC_ALL toute la localisation,
LC_COLLATE
la mise en correspondance des expressions rationnelles (classes
d'equivalence et intervalles), et le classement des chaines de
caracteres,
LC_CTYPE
la classification de caractere et les routines de conversions.la
mise en correspondance des expressions rationnelles, la
classification de caracteres, les conversions, les comparaisons
dependant de la casse et les fonctions pour les caracteres
larges.
LC_MESSAGES
les messages en langue naturelle
LC_MONETARY
l'affichage des valeurs monetaires.
LC_NUMERIC
le symbole decimal (point, virgule, ...)
LC_TIME
la forme de la date et l'heure.
L'argument locale est un pointeur sur une chaine de caracteres
contenant la configuration de la categorie. Une telle chaine peut etre
une constante bien connue, comme << C >> ou << fr_FR >> (voir plus bas)
ou une chaine opaque renvoyee par un autre appel precedent a
setlocale().
Si locale est "", chaque partie de la localisation doit etre modifiee
en fonction des variables d'environnement. Les details d'implementation
varient. Pour la glibc, d'abord (quelle que soit la categorie) la
variable d'environnement LC_ALL est examinee, puis la variable
d'environnement avec le meme nom que la categorie (LC_COLLATE,
LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, LC_TIME) et finalement
la variable LANG. La premiere variable d'environnement existant est
utilisee. Si sa valeur n'est pas une specification de localisation
valide, la localisation n'est pas modifiee, et setlocale() renvoie
NULL.
Les localisations "C" et "POSIX" sont portables, leur partie LC_CTYPE
correspond au jeu de caracteres ASCII 7 bits.
Un nom de localisation est typiquement de la forme
langue[_territoire][.codeset][@modificateur], ou la langue est un code
linguistique ISO 639, le territoire un code de pays ISO 3166, et
codeset un jeu de caracteres ou un identifiant d'encodage, comme
ISO-8859-1 ou UTF-8. Pour voir une liste de toutes les localisations
disponibles, essayez << locale -a >>, cf. locale(1).
Si locale est NULL, la localisation courante est consultee, mais pas
modifiee.
Au demarrage, la localisation portable "C" est selectionnee par defaut.
Un programme peut etre rendu portable en appelant :
setlocale(LC_ALL, "");
lors de son initialisation, en utilisant les valeurs renvoyees par
localeconv(3) pour les valeurs dependant de la localisation, en
utilisant les fonctions multioctet et caracteres larges pour traiter
les chaines si MB_CUR_MAX > 1, et en utilisant strcoll(3), wcscoll(3)
ou strxfrm(3), wcsxfrm(3) pour comparer les chaines de caracteres.
VALEUR RENVOY'EE
Un appel reussi a setlocale() renvoie une chaine correspondant a la
localisation. Cette chaine peut etre allouee dans une zone statique. La
chaine est renvoyee de telle maniere qu'un appel ulterieur avec cette
chaine et la categorie associee restituera cette partie de la
localisation du processus. La valeur renvoyee est NULL si la demande ne
peut pas etre honoree.
CONFORMIT'E
C89, C99, POSIX.1-2001.
NOTES
Linux (c'est-a-dire la glibc) supporte les localisations portables "C"
et "POSIX". Il y avait auparavant un support pour le Latin-1 europeen
"ISO-8859-1" (par exemple dans la libc-4.5.21 et libc-4.6.27), ainsi
que et le "KOI-8" russe (plus precisement "koi-8r" dans la
libc-4.6.27). Il suffisait alors d'initialiser la variable
d'environnement LC_CTYPE=ISO-8859-1 pour que isprint(3) fonctionne
correctement. Desormais, les europeens non anglophones doivent peiner
un peu plus pour installer les veritables fichiers de localisation.
VOIR AUSSI
locale(1), localedef(1), isalpha(3), localeconv(3), nl_langinfo(3),
rpmatch(3), strcoll(3), strftime(3), charsets(7), locale(7)
COLOPHON
Cette page fait partie de la publication 3.32 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Nicolas
Francois et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
GNU 5 decembre 2008 SETLOCALE(3)