_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Teste et convertit la casse d’un caractère multioctet.

Important

Cette API ne peut pas être utilisée dans les applications qui s’exécutent dans le Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.

Syntaxe

unsigned int _mbctolower(
   unsigned int c
);
unsigned int _mbctolower_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctoupper(
   unsigned int c
);
unsigned int _mbctoupper_l(
   unsigned int c,
   _locale_t locale
);

Paramètres

c
Caractère multioctet à convertir.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces fonctions retourne le caractère converti c, si possible. Sinon, elle retourne le caractère c inchangé.

Notes

Les fonctions testent un caractère c et, dans la mesure du possible, appliquent l’une des conversions suivantes.

Routines	Conversion
_mbctolower, _mbctolower_l	Caractère majuscule en caractère minuscule.
_mbctoupper, _mbctoupper_l	Caractère minuscule en caractère majuscule.

La valeur de sortie est affectée par le paramètre de catégorie LC_CTYPE des paramètres régionaux. Pour plus d’informations, consultez setlocale. La version de cette fonction dépourvue du suffixe _l utilise les paramètres régionaux actifs pour ce comportement dépendant des paramètres régionaux ; la version assortie du suffixe _l est identique, à ceci près qu’elle utilise à la place les paramètres régionaux transmis. Pour plus d’informations, consultez Locale.

Dans les versions précédentes, _mbctolower a été appelé jtolower, et _mbctoupper a été appelé jtoupper. Pour le nouveau code, utilisez les nouveaux noms à la place.

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 routine de texte générique

Routine Tchar.h	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l

Spécifications

Routines	En-tête requis
_mbctolower, _mbctolower_l	<mbstring.h>
_mbctoupper, _mbctoupper_l	<mbstring.h>

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

Voir aussi

Conversion de données
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctombb, _mbctombb_l