toupper, _toupper, towupper, _toupper_l, _towupper_l

Convertit le caractère en majuscule.

Syntaxe

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Paramètres

c
Caractère à convertir.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces routines convertit une copie de c, si possible, et retourne le résultat.

Si c est un caractère large pour lequel iswlower a une valeur différente de zéro et s’il existe un caractère large correspondant pour lequel iswupper a une valeur différente de zéro, towupper retourne le caractère large correspondant ; sinon, towupper retourne c inchangé.

Il n’existe aucune valeur de retour réservée pour indiquer une erreur.

Notes

Chacune de ces routines convertit une lettre minuscule donnée en lettre majuscule si cela est possible et approprié. La conversion de la casse de towupper est spécifique aux paramètres régionaux. Seuls les caractères relevant des paramètres régionaux actifs changent de casse. Les fonctions sans suffixe _l utilisent les paramètres régionaux actuellement définis. Les versions de ces fonctions avec suffixe _l prennent les paramètres régionaux comme paramètre et les utilisent à la place des paramètres régionaux actuellement définis. Pour plus d’informations, consultez Locale.

Pour que toupper donne des résultats attendus, __isascii doit retourner une valeur autre que zéro.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Remarque

Les routines _toupper_l et _towupper_l ne dépendent pas des paramètres régionaux et ne sont pas destinées à être appelées directement. Elles sont fournies pour une utilisation en interne par _totupper_l.

Spécifications

Routine	En-tête requis
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple dans to, fonctions.

Voir aussi

Routines is, isw
to, fonctions
Paramètres régionaux
Interprétation des séquences de caractères multioctets