_ismbslead, _ismbstrail, _ismbslead_l, _ismbstrail_l

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

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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 al precedente byte iniziale noto.

current
Puntatore alla posizione nella stringa da testare.

locale
Impostazioni locali da usare.

Valore restituito

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

Osservazioni:

_ismbslead e _ismbstrail sono più lenti delle versioni _ismbblead e _ismbbtrail perché prendono 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 comportamento dipendente dalle impostazioni locali, usano le impostazioni locali passate anziché quelle correnti. Per altre informazioni, vedere Locale.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	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>

* Per le costanti manifesto per le condizioni di test.

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Classificazione dei caratteri
_ismbc Routine
is, isw routine
_ismbb Routine