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> ».