uselocale

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);

uselocale() :

    Depuis la version 2.10 de la glibc :
        _XOPEN_SOURCE >= 700
    Avant la version 2.10 de la glibc :
        _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.

VERSIONS

La fonction uselocale() est apparue pour la première fois dans la glibc 2.3.

STANDARDS

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 <[email protected]>, Thierry Vignaud <[email protected]>, François Micaux, Alain Portal <[email protected]>, Jean-Philippe Guérard <[email protected]>, Jean-Luc Coulon (f5ibh) <[email protected]>, Julien Cristau <[email protected]>, Thomas Huriaux <[email protected]>, Nicolas François <[email protected]>, Florentin Duneau <[email protected]>, Simon Paillard <[email protected]>, Denis Barbier <[email protected]> et David Prévot <[email protected]> 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 à [email protected]