_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
is, isw routines
_ismbb Routines