_ismbslead, _ismbstrail, _ismbslead_l, _ismbstrail_l

Articolo
06/09/2015

Esegue test sensibili al contesto per i byte iniziali e finali della stringa con caratteri multibyte e determina se un puntatore ad una data sottostinga punta ad un byte iniziale o finale.

Importante

Questa API non può essere utilizzata nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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
);

Parametri

str
Puntatore all'inizio della stringa o il byte iniziale precedente noto.
current
Puntatore alla posizione nella stringa da testare.
locale
Impostazioni locali da utilizzare.

Valore restituito

_ismbslead restituisce - 1 se il carattere è un byte iniziale e _ismbstrail restituisce -1 se il carattere è un byte finale. Se le stringhe di input sono valide ma non rappresentano un byte iniziale o finale, queste funzioni restituiscono zero. Se l'argomento è NULL, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono NULL e impostano errno su EINVAL.

Note

_ismbslead e _ismbstrail sono più lenti delle versioni _ismbbtrail e _ismbblead perché tengono in considerazione il contesto della stringa.

Le versioni di queste funzioni che presentano il suffisso _l sono identiche ad eccezione del fatto che per il loro comportamento dipendente dalle impostazioni locali esse utilizzano le impostazioni locali passate anziché quelle correnti. Per ulteriori informazioni, vedere Impostazioni locali.

Requisiti

Routine	Intestazione obbligatoria	Intestazione facoltativa
_ismbslead	<mbctype.h> o <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>
_ismbstrail	<mbctype.h> o <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>
_ismbslead_l	<mbctype.h> o <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>
_ismbstrail_l	<mbctype.h> o <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>