Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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.27  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)