_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

Vérifie si un caractère multioctet est un caractère autorisé ou un symbole.

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

int _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_l(
   unsigned int c,
   _locale_t locale
);

Paramètres

c
Caractère à tester.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces routines retourne une valeur différente de zéro si le caractère satisfait à la condition de test. Sinon, ils retournent 0. Si c<= 255 et qu’il existe une routine correspondante _ismbb (par exemple, _ismbcalnum correspond à _ismbbalnum), le résultat est la valeur de retour de la routine correspondante _ismbb .

Notes

Chacune de ces fonctions teste un caractère multioctet fourni pour un état donné.

Les versions de ces fonctions avec le suffixe _l sont identiques, sauf qu'elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux actuels pour leur comportement dépendant des paramètres régionaux. Pour plus d’informations, consultez Locale.

Routine	Condition de test	Exemple de page de codes 932
_ismbclegal	Multioctet valide	Retourne une valeur différente de zéro si, et seulement si, le premier octet de c appartient à la plage 0x81-0x9F ou 0xE0-0xFC et que le deuxième octet appartient à la plage 0x40-0x7E ou 0x80-FC.
_ismbcsymbol	Symbole multioctet	Retourne une valeur différente de zéro si et uniquement si 0x8141<==c<0x81AC.

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
_istlegal	Retourne toujours la valeur false	_ismbclegal	Retourne toujours la valeur false.
_istlegal_l	Retourne toujours la valeur false	_ismbclegal_l	Retourne toujours la valeur false.

Spécifications

Routine	En-tête requis
_ismbclegal, _ismbclegal_l	<mbstring.h>
_ismbcsymbol, _ismbcsymbol_l	<mbstring.h>

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

Voir aussi

Classification des caractères
_ismbc Routines
is, isw routines
_ismbb Routines