_mbbtype, _mbbtype_l

  • Articolo

Restituisce il tipo di byte, in base al byte precedente.

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 _mbbtype(
   unsigned char c,
   int type
);
int _mbbtype_l(
   unsigned char c,
   int type,
   _locale_t locale
);

Parametri

c
Carattere da testare.

type
Tipo di byte per cui effettuare il test.

locale
Impostazioni locali da usare.

Valore restituito

_mbbtype restituisce il tipo di byte all'interno di una stringa. Questa decisione è sensibile al contesto, come specificato dal valore di type, che fornisce la condizione di test del controllo. type è il tipo byte precedente nella stringa. Le costanti manifesto nella tabella seguente sono definite in Mbctype.h.

Valore di type _mbbtype esegue il test per Valore restituito c
Qualsiasi valore eccetto 1 Byte singolo o byte iniziale valido _MBC_SINGLE (0) Byte singolo (0x20 - 0x7E, 0xA1 - 0xDF)
Qualsiasi valore eccetto 1 Byte singolo o byte iniziale valido _MBC_LEAD (1) Byte iniziale di carattere multibyte (0x81 - 0x9F, 0xE0 - 0xFC)
Qualsiasi valore eccetto 1 Byte singolo o byte iniziale valido _MBC_ILLEGAL

(-1)		 Carattere non valido (qualsiasi valore tranne 0x20 - 0x7E, 0xA1 - 0xDF, 0x81 - 0x9F, 0xE0 - 0xFC
1 Byte finale valido _MBC_TRAIL (2) Byte finale di carattere multibyte (0x40 - 0x7E, 0x80 - 0xFC)
1 Byte finale valido _MBC_ILLEGAL

(-1)		 Carattere non valido (qualsiasi valore tranne 0x20 - 0x7E, 0xA1 - 0xDF, 0x81 - 0x9F, 0xE0 - 0xFC

Osservazioni:

La funzione _mbbtype determina il tipo di byte in un carattere multibyte. Se il valore di type è qualsiasi valore eccetto 1, _mbbtype testa un byte singolo valido o un byte iniziale di un carattere multibyte. Se il valore di type è 1, _mbbtype testa un byte finale valido di un carattere multibyte.

Il valore di output è interessato dall'impostazione dell'impostazione LC_CTYPE della categoria delle impostazioni locali. Per altre informazioni, vedere setlocalee _wsetlocale. La versione di questa funzione usa le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali. La _mbbtype _mbbtype_l versione è identica, ad eccezione del fatto che usa il parametro delle impostazioni locali passato. Per altre informazioni, vedere Locale.

Nelle versioni precedenti, _mbbtype è stato denominato chkctype. Per un nuovo codice, usare in alternativa _mbbtype.

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
_mbbtype <mbstring.h> <mbctype.h>*
_mbbtype_l <mbstring.h> <mbctype.h>*

* Per le definizioni delle costanti manifesto utilizzate come valori restituiti.

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

Vedi anche

Classificazione dei byte