Nous recommandons d’utiliser Visual Studio 2017

_mbsbtype, _mbsbtype_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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

System_CAPS_ICON_important.jpg 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 avec /ZW.

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 de début de la chaîne d’octets.

locale
Paramètres régionaux à utiliser.

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

Valeur de retourByte (type)
_MBC_SINGLE (0)Caractère sur un octet. Par exemple, dans la page de codes 932, _mbsbtype retourne 0 si l’octet spécifié est dans la plage 0 x 20 – 0x7E ou 0xA1 – 0xDF.
_MBC_LEAD (1)Un octet en tête des caractères multioctets. Par exemple, dans la page de codes 932, _mbsbtype renvoie la valeur 1 si l’octet spécifié est dans la plage 0 x 81 à 0x9F ou 0xE0 – 0xFC.
_MBC_TRAIL (2)Les octets de caractères multioctets. Par exemple, dans la page de codes 932, _mbsbtype renvoie la valeur 2 si l’octet spécifié est dans la plage 0 x 40 – 0x7E ou 0 x 80 – 0xFC.
_MBC_ILLEGAL (–1)NULLchaîne, de caractère non valide, ou NULL octets se trouvant avant l’octet au décalage count dans mbstr.

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

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

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

RoutineEn-tête requisEn-tête facultatif
_mbsbtype<mbstring.h><mbctype.h>*
_mbsbtype_l<mbstring.h><mbctype.h>*

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

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

Non applicable, mais consultez System::Globalization::CultureInfo.

Classification d’octets

Afficher: