USELOCALE(3)

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.70 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 à <perkamon-fr@traduc.org>.

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