towupper_l

NOM

towupper, towupper_l - Convertir un caractère large en majuscule

BIBLIOTHÈQUE

Bibliothèque C standard ( libc, -lc)

SYNOPSIS

#include <wctype.h>

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

towupper_l() :

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

VERSIONS

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

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

Interface	Attribut	Valeur
towupper()	Sécurité des threads	MT-Safe locale
towupper_l()	Sécurité des threads	MT-Safe

STANDARDS

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

VOIR AUSSI

iswupper(3), towctrans(3), towlower(3), 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]