NOM

       uselocale - Définir ou obtenir les paramètres régionaux pour le thread appelant

SYNOPSIS

       #include <locale.h>

       locale_t uselocale(locale_t newloc);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       uselocale() :
           Depuis la glibc 2.10 :
                  _XOPEN_SOURCE >= 700
           Avant la glibc 2.10 :
                  _GNU_SOURCE

DESCRIPTION

       La fonction uselocale() définit les paramètres régionaux actuels pour le  thread  appelant
       et  renvoie  les  paramètres  régionaux  précédents  du  thread.  Après un appel réussi de
       uselocale(), tous les  appels  par  ce  thread  des  fonctions  dépendant  des  paramètres
       régionaux fonctionneront comme si les paramètres régionaux avaient été définis à newloc.

       L’argument newloc peut avoir l'une des valeurs suivantes :

       Un identifiant renvoyé par un appel de newlocale(3) ou duplocale(3)
              Les  paramètres  régionaux  actuels  du thread appelant sont définis aux paramètres
              régionaux indiqués.

       L’identifiant d’objet spécial de paramètres régionaux LC_GLOBAL_LOCALE
              Les paramètres régionaux actuels du thread appelant  sont  définis  aux  paramètres
              régionaux généraux déterminés par setlocale(3).

       (locale_t) 0
              Les  paramètres régionaux actuels du thread appelant sont laissés inchangés (et les
              paramètres régionaux actuels sont renvoyés comme résultat de la fonction).

VALEUR RENVOYÉE

       En cas de réussite, uselocale() renvoie l’identifiant de paramètres régionaux qui  étaient
       définis  par le précédent appel de uselocale() dans ce thread ou LC_GLOBAL_HANDLE s’il n’y
       a pas eu d’appel précédent. En cas d’erreur, elle renvoie (locale_t) 0  et  définit  errno
       pour indiquer la raison de l’erreur.

ERREURS

       EINVAL newloc ne fait pas référence à un objet de paramètres régionaux valable.

VERSIONS

       La  fonction  uselocale()  est  apparue  pour  la  première fois dans la version 2.3 de la
       bibliothèque C de GNU.

CONFORMITÉ

       POSIX.1-2008.

NOTES

       Contrairement à setlocale(3), uselocale()  ne  permet  pas  le  remplacement  sélectif  de
       catégories de paramètres régionaux individuels. Pour utiliser des paramètres régionaux qui
       ne différent que de quelques catégories des paramètres  régionaux  actuels,  utilisez  des
       appels  à  duplocale(3)  et  newlocale(3)  pour  obtenir  un objet de paramètres régionaux
       équivalent aux paramètres régionaux actuels et modifier les catégories  voulues  dans  cet
       objet.

EXEMPLE

       Consultez newlocale(3) et duplocale(3).

VOIR AUSSI

       locale(1), duplocale(3), freelocale(3), newlocale(3), setlocale(3), locale(5), locale(7)

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».