_mbbtype, _mbbtype_l
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 : pas un seul ou un prospect (0x00 - 0x1F, 0x7F, 0x80, 0xA0, 0xFD, 0xFE, 0xFF) |
| 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 : non valide (0x00 - 0x3F, 0x7F, 0xFD, 0xFE, 0xFF) |
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.