_ismbslead
, , _ismbstrail
_ismbslead_l
, ,_ismbstrail_l
Effectue des tests contextuels pour les octets de tête et de fin des chaînes de caractères multioctets et détermine si un pointeur de sous-chaîne pointe vers un octet de tête ou un octet de fin.
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 _ismbslead(
const unsigned char *str,
const unsigned char *current
);
int _ismbstrail(
const unsigned char *str,
const unsigned char *current
);
int _ismbslead_l(
const unsigned char *str,
const unsigned char *current,
_locale_t locale
);
int _ismbstrail_l(
const unsigned char *str,
const unsigned char *current,
_locale_t locale
);
Paramètres
str
Pointeur indiquant le début de la chaîne ou l'octet de tête connu précédent.
current
Pointeur indiquant la position dans la chaîne à tester.
locale
Paramètres régionaux à utiliser.
Valeur retournée
_ismbslead
renvoie -1 si le caractère est un octet de prospect et _ismbstrail
retourne -1 si le caractère est un octet de fin. Si les chaînes d’entrée sont valides, mais ne sont pas un octet de prospect ou un octet de fin, ces fonctions retournent zéro. Si l’un ou l’autre argument 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, ces fonctions retournent NULL
et définissent errno
avec la valeur EINVAL
.
Notes
_ismbslead
et _ismbstrail
sont plus lentes que les versions _ismbblead
et _ismbbtrail
, car elles prennent en compte le contexte des chaînes.
Les versions de ces fonctions avec le suffixe _l
sont identiques, à ceci près que pour leur comportement dépendant des paramètres régionaux, elles utilisent les paramètres régionaux qui sont passés au lieu des paramètres régionaux actifs. Pour plus d’informations, consultez Locale.
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 |
---|---|---|
_ismbslead |
<mbctype.h> ou <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbstrail |
<mbctype.h> ou <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbslead_l |
<mbctype.h> ou <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbstrail_l |
<mbctype.h> ou <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
* Pour les constantes de manifeste pour les conditions de test.
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Voir aussi
Classification des caractères
_ismbc
Routines
Routines is
, isw
_ismbb
Routines