toupper, _toupper, towupper, _toupper_l, _towupper_l

Article
06/09/2015

Convertie des caractères en majuscules.

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 de retour

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

Si c est un caractère large pour lequel iswlower est différente de zéro et qu'il y a un caractère large correspondant pour lequel iswupper est différente de zéro, towupper retourne le caractère large correspondant ; sinon, towupper retournec inchangé.

Aucune valeur de retour n'est réservée pour indiquer une erreur.

Pour que toupper montre les résultats attendus, __isascii et islower doivent tous les deux retourner une valeur non nulle.

Notes

Chacune de ces routines convertit une lettre minuscule donnée en un caractère majuscule lorsque cela est possible et approprié. La conversion en majuscules ou minuscules detowupper est spécifique aux paramètres locaux. Seuls les caractères concernant les paramètres locaux actuels sont modifiés en cas de. Les fonctions sans le suffixe _l utilisent les paramètres locaux actuellement définis. Les versions de ces fonctions avec le suffixe _l sont identiques, sauf qu'elles utilisent les paramètres locaux passés au lieu des paramètres locaux actuels. Pour plus d'informations, consultez Paramètres régionaux.

Pour que toupper montre les résultats attendus, __isascii et islower doivent tous les deux retourner une valeur non nulle.

routines de conversion de données

Mappages de routines de texte générique

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

Notes

_toupper_l et _towupper_l n'ont aucune dépendance de paramètres régionaux et ne sont pas censés être appelés directement.Ils sont fournis pour un usage interne par _totupper_l.