_mbbtype, _mbbtype_l

  • Article

Retourne le type d'octet en se basant sur l'octet précédent.

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 _mbbtype(
   unsigned char c,
   int type
);
int _mbbtype_l(
   unsigned char c,
   int type,
   _locale_t locale
);

Paramètres

c
Caractère à tester.

type
Type d'octet à tester.

locale
Paramètres régionaux à utiliser.

Valeur retournée

_mbbtype retourne le type d'octet dans une chaîne. Cette décision tient compte du contexte, tel que spécifié par la valeur de type, qui fournit la condition du test de contrôle. type est le type de l'octet précédent dans la chaîne. Les constantes manifestes présentes dans le tableau suivant sont définies dans Mbctype.h.

Valeur de type _mbbtype teste la présence de Valeur retournée c
Toute valeur sauf 1 Octet unique ou octet de tête valide _MBC_SINGLE (0) Octet unique (0x20 - 0x7E, 0xA1 - 0xDF)
Toute valeur sauf 1 Octet unique ou octet de tête valide _MBC_LEAD (1) Octet de prospect de caractère multioctet (0x81 - 0x9F, 0xE0 - 0xFC)
Toute valeur sauf 1 Octet unique ou octet de tête valide _MBC_ILLEGAL

(-1)		 Caractère non valide (n’importe quelle valeur, sauf 0x20 - 0x7E, 0xA1 - 0xDF, 0x81 - 0x9F, 0xE0 - 0xFC
1 Octet de fin valide _MBC_TRAIL (2) Octet de fin de caractère multioctet (0x40 - 0x7E, 0x80 - 0xFC)
1 Octet de fin valide _MBC_ILLEGAL

(-1)		 Caractère non valide (n’importe quelle valeur, sauf 0x20 - 0x7E, 0xA1 - 0xDF, 0x81 - 0x9F, 0xE0 - 0xFC

Notes

La fonction _mbbtype détermine le type d'un octet dans un caractère multioctet. Si la valeur de type est une valeur différente de 1, _mbbtype teste la présence d'un octet unique ou d'un octet de tête valide dans un caractère multioctet. Si la valeur de type est égale à 1, _mbbtype teste la présence d'un octet de fin valide dans un caractère multioctet.

La valeur de la sortie est affectée par la valeur du paramètre de la catégorie LC_CTYPE des paramètres régionaux. Pour plus d’informations, consultez setlocale, _wsetlocale. La _mbbtype version de cette fonction utilise les paramètres régionaux actuels pour ce comportement dépendant des paramètres régionaux ; la _mbbtype_l version est identique, sauf qu’elle utilise le paramètre de paramètres régionaux passé à la place. Pour plus d’informations, consultez Locale.

Dans les versions antérieures, _mbbtype était nommé chkctype. Pour le nouveau code, utilisez _mbbtype.

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

Spécifications

Routine En-tête requis En-tête facultatif
_mbbtype <mbstring.h> <mbctype.h>*
_mbbtype_l <mbstring.h> <mbctype.h>*

* Pour les définitions de constantes manifeste utilisées comme valeurs de retour.

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

Voir aussi

Classification d’octets