NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <locale.h>

       locale_t uselocale(locale_t newloc);

   Exigences de macros de test de fonctionnalités pour la glibc (consulter 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_LOCALE 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 l’erreur.

ERREURS

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

STANDARDS

       POSIX.1-2008.

HISTORIQUE

       glibc 2.3. 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.

EXEMPLES

       Consultez newlocale(3) et duplocale(3).

VOIR AUSSI

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

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>, François Micaux, Alain Portal  <aportal@univ-montp2.fr>,  Jean-Philippe  Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,     Thomas     Huriaux      <thomas.huriaux@gmail.com>,      Nicolas      François
       <nicolas.francois@centraliens.net>,     Florentin     Duneau    <fduneau@gmail.com>,    Simon    Paillard
       <simon.paillard@resel.enst-bretagne.fr>,   Denis   Barbier   <barbier@debian.org>   et    David    Prévot
       <david@tilapin.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                       uselocale(3)