_mbsbtype, _mbsbtype_l
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 les fenêtres d'exécution.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 d'octet de tête de chaîne.locale
Paramètres régionaux à utiliser.
Valeur de retour
_mbsbtype et _mbsbtype_lretourne 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'octets |
|---|---|
_MBC_SINGLE (0) |
Caractère codé sur un octet.Par exemple, dans la page de codes 932, _mbsbtype retourne 0 si l'octet est spécifié dans la plage 0x20 – 0x7E ou 0xA1 – 0xDF. |
_MBC_LEAD (1) |
Octet de tête de caractères multioctet.Par exemple, dans la page de codes 932, _mbsbtype retourne 1 si l'octet est spécifié dans la plage 0x81 à 0x9F ou 0xE0 – 0xFC. |
_MBC_TRAIL (2) |
Octet de queue de caractères multioctet.Par exemple, dans la page de codes 932, _mbsbtype retourne 2 si l'octet est spécifié dans la plage 0x40 – 0x7E ou 0x80 – 0xFC. |
_MBC_ILLEGAL (–1) |
la chaîne d'NULL, le caractère non valide, ou l'octet de NULL a trouvé avant l'octet à l'adresse offset count dans mbstr. |
Notes
La fonction d' _mbsbtype détermine le type d'un octet dans une chaîne de caractères multioctets.La fonction vérifie uniquement l'octet à l'adresse offset count dans mbstr, en ignorant des caractères non valides avant l'octet spécifié.
La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPE des paramètres régionaux ; consultez l' setlocale pour plus d'informations.La version de cette fonction sans suffixe d' _l utilise les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; la version avec le suffixe d' _l est identique à la différence qu'il utilisation que le paramètre de paramètres régionaux est passée à la place.Pour plus d'informations, consultez Paramètres régionaux.
Si la chaîne d'entrée est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errno a la valeur 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 de compatibilité, consultez l' Compatibilité dans l'introduction.
Équivalent .NET Framework
Non applicable, mais consultez l' System::Globalization::CultureInfo.