_mbbtype
, _mbbtype_l
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: non singolo o lead (0x00 - 0x1F, 0x7F, 0x80, 0xA0, 0xFD, 0xFE, 0xFF) |
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: non finale (0x00 - 0x3F, 0x7F, 0xFD, 0xFE, 0xFF) |
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 setlocale
e _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à).