towupper(3) Convertir un caractère large en majuscule

Other Alias

towupper_l

SYNOPSIS

#include <wctype.h>


wint_t towupper(wint_t wc);
wint_t towupper_l(wint_t wc, locale_t locale);

Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

towupper_l() :

Depuis la glibc 2.10 :
_XOPEN_SOURCE >= 700
Avant la glibc 2.10 :
_GNU_SOURCE

DESCRIPTION

La fonction towupper() est l'équivalent de toupper(3) pour les caractères larges. Si wc est un caractère large minuscule et que son équivalent en majuscule existe dans la locale utilisée, la fonction renvoie l'équivalent en majuscule de wc. Dans les autres cas, wc est renvoyé sans modification.

towupper_l() effectue la même tâche, mais effectue la conversion en utilisant le jeu de caractères de la locale indiquée par locale. Le comportement de towupper_l() est indéfini si locale est la locale spéciale LC_GLOBAL_LOCALE (voir duplocale(3)) ou s'il ne s'agit pas d'une locale valable.

Le paramètre wc doit être un caractère descriptible avec le type wchar_t et valable dans la locale utilisée, ou valoir WEOF.

VALEUR RENVOYÉE

Si wc est convertible en majuscule, towupper() renvoie son équivalent en majuscule, sinon renvoie wc.

ATTRIBUTS

Multithreading (voir pthreads(7))

La fonction towupper() est sûre dans un contexte multithread avec exceptions. Elle peut être utilisée de manière sûre tant que setlocale(3) n'est pas appelée pour modifier la locale pendant son exécution.

VERSIONS

La fonction towupper_l() est apparue dans la glibc 2.3.

CONFORMITÉ

towupper() : C99, POSIX.1-2001 (XSI) ; présente dans POSIX.1-2008 en tant qu'extension XS mais marquée obsolète.

towupper_l() : POSIX.1-2008.

NOTES

Le comportement de ces fonctions dépend de la catégorie LC_CTYPE de la localisation.

Ces fonctions ne sont pas très appropriées pour traiter les caractères Unicode, car ils existent en trois casses : « upper », « lower » et « title ».

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

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <[email protected]> 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> ».