Partager via

_mbsbtype, _mbsbtype_l

  • Article

Retourne le type d’octet dans une chaîne.

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 _mbsbtype(
   const unsigned char *mbstr,
   size_t count
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale
);

Paramètres

mbstr
Adresse d’une séquence de caractères multioctets.

count
Décalage d’octet à partir du début de la chaîne.

locale
Paramètres régionaux à utiliser.

Valeur retournée

_mbsbtype retourne _mbsbtype_l une valeur entière indiquant le résultat du test sur l’octet spécifié. Les constantes manifestes présentes dans le tableau suivant sont définies dans Mbctype.h.

Valeur retournée Type d’octet
_MBC_SINGLE (0) Caractère codé sur un octet. Par exemple, dans la page de codes 932, _mbsbtype retourne 0 si l’octet spécifié se trouve dans la plage 0x20 - 0x7E ou 0xA1 - 0xDF.
_MBC_LEAD (1) Octet de tête de caractère multioctet. Par exemple, dans la page de codes 932, _mbsbtype retourne 1 si l’octet spécifié se trouve dans la plage 0x81 - 0x9F ou 0xE0 - 0xFC.
_MBC_TRAIL (2) Octet de fin de caractère multioctet. Par exemple, dans la page de codes 932, _mbsbtype retourne 2 si l’octet spécifié se trouve dans la plage 0x40 - 0x7E ou 0x80 - 0xFC.
_MBC_ILLEGAL (-1) NULL chaîne, caractère non valide ou octet null trouvé avant l’octet au décalage count dans mbstr.

Notes

La fonction _mbsbtype détermine le type d’un octet dans une chaîne de caractères multioctets. La fonction examine uniquement l’octet au décalage count dans mbstr, en ignorant les caractères non valides avant l’octet spécifié.

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. 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.

Si la chaîne d’entrée est NULL, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, errno a la valeur EINVAL et la fonction retourne _MBC_ILLEGAL.

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
_mbsbtype <mbstring.h> <mbctype.h>*
_mbsbtype_l <mbstring.h> <mbctype.h>*

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

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

Voir aussi

Classification d’octets