_ismbclegal, _ismbclegal_l, _ismbcsymbol_ismbcsymbol_l

Verifica se un carattere multibyte è un carattere valido o simbolo.

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 _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_l(
   unsigned int c,
   _locale_t locale
);

Parametri

c
Carattere da testare.

locale
Impostazioni locali da usare.

Valore restituito

Ognuna di queste routine restituisce un valore diverso da zero se il carattere soddisfa la condizione di test. In caso contrario, restituiscono 0. Se c<= 255 e c'è una routine corrispondente _ismbb (ad esempio, _ismbcalnum corrisponde a _ismbbalnum), il risultato è il valore restituito della routine corrispondente _ismbb .

Osservazioni:

Ognuna di queste funzioni testa una particolare condizione su un determinato carattere multibyte.

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.

Ciclo	Condizione di test	Esempio della tabella codici 932
_ismbclegal	Multibyte valido	Restituisce un valore diverso da zero se e solo se il primo byte di c è compreso negli intervalli 0x81 - 0x9F o 0xE0 - 0xFC, mentre il secondo byte è compreso negli intervalli 0x40 - 0x7E o 0x80 - FC.
_ismbcsymbol	Simbolo multibyte	Restituisce un valore diverso da zero se e solo se 0x8141<==c<0x81AC.

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

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS definito	_UNICODE definito
_istlegal	Restituisce sempre false	_ismbclegal	Restituisce sempre false.
_istlegal_l	Restituisce sempre false	_ismbclegal_l	Restituisce sempre false.

Requisiti

Ciclo	Intestazione obbligatoria
_ismbclegal, _ismbclegal_l	<mbstring.h>
_ismbcsymbol, _ismbcsymbol_l	<mbstring.h>

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

Vedi anche

Classificazione dei caratteri
_ismbc Routine
is, isw routine
_ismbb Routine