uselocale
Section: C Library Functions (3)
Updated: 4 décembre 2022
Index
Return to Main Contents
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 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 <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 à
Index
- NOM
-
- BIBLIOTHÈQUE
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- VERSIONS
-
- STANDARDS
-
- NOTES
-
- EXEMPLES
-
- VOIR AUSSI
-
- TRADUCTION
-
This document was created by
man2html,
using the manual pages.
Time: 04:00:30 GMT, May 18, 2024