_mbsbtype, _mbsbtype_l

Article
06/09/2015

Retourne le type d'octets 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 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 une séquence de caractères multioctets.
count
Décalage d'octet à partir de la tête de chaîne.
locale
Paramètres régionaux à utiliser.

Valeur de retour

_mbsbtype et _mbsbtype_lretournent une valeur entière indiquant le résultat du test dans l'octet spécifié. Les constantes manifestes dans le tableau suivant sont définies dans Mbctype.h.

Valeur de retour	Type d'octet
_MBC_SINGLE (0)	Caractère simple 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 multioctets. 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)	La chaîne NULL, le caractère non valide, ou l'octet NULL a été trouvé avant l'octet d'offset 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 à l'offset 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 ; consultez setlocale, pour plus d'informations. La version de cette fonction sans le suffixe _l utilise les paramètres régionaux pour ce comportement dépendant des paramètres régionaux ; la version avec le suffixe _l est identique, sauf qu'elle utilise à la place les paramètres régionaux transmis. Pour plus d'informations, consultez Paramètres régionaux.

Si la chaîne donné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 est défini comme EINVAL et la fonction retourne _MBC_ILLEGAL.

Configuration requise

Routine	En-tête requis	En-tête facultatif
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

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

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Équivalent .NET Framework

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

Voir aussi

Référence

Classification d'octets

Partager via