_mbsbtype, _mbsbtype_l
Restituisce il tipo di byte all'interno di una stringa.
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 _mbsbtype(
const unsigned char *mbstr,
size_t count
);
int _mbsbtype_l(
const unsigned char *mbstr,
size_t count,
_locale_t locale
);
Parametri
mbstr
Indirizzo di una sequenza di caratteri multibyte.
count
Offset dall'inizio della stringa in byte.
locale
Impostazioni locali da usare.
Valore restituito
_mbsbtype e _mbsbtype_l restituisce un valore intero che indica il risultato del test sul byte specificato. Le costanti manifesto nella tabella seguente sono definite in Mbctype.h.
| Valore restituito | Tipo di byte |
|---|---|
_MBC_SINGLE (0) |
Carattere a byte singolo. Nella tabella codici 932, ad esempio, restituisce _mbsbtype 0 se il byte specificato è compreso nell'intervallo 0x20, 0x7E o 0xA1, 0xDF. |
_MBC_LEAD (1) |
Byte di apertura del carattere multibyte. Nella tabella codici 932, ad esempio, _mbsbtype restituisce 1 se il byte specificato è compreso nell'intervallo 0x81, 0x9F o 0xE0, 0xFC. |
_MBC_TRAIL (2) |
Byte di chiusura del carattere multibyte. Nella tabella codici 932, ad esempio, restituisce _mbsbtype 2 se il byte specificato è compreso nell'intervallo 0x40, 0x7E o 0x80, 0xFC. |
_MBC_ILLEGAL (-1) |
NULL stringa, carattere non valido o byte null trovato prima del byte in corrispondenza dell'offset count in mbstr. |
Osservazioni:
La funzione _mbsbtype determina il tipo di un byte in una stringa di caratteri multibyte. La funzione esamina solo i byte in corrispondenza dell'offset count in mbstr, ignorando i caratteri non validi prima del byte specificato.
Il valore di output è interessato dall'impostazione dell'impostazione LC_CTYPE della categoria delle impostazioni locali. Per ulteriori informazioni, vedere setlocale. La versione di questa funzione senza il suffisso _l utilizza le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; la versione con il suffisso _l è identica, ad eccezione del fatto che utilizza il parametro delle impostazioni locali passato. Per altre informazioni, vedere Locale.
Se la stringa di input è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostato su EINVAL e la funzione restituisce _MBC_ILLEGAL.
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 |
|---|---|---|
_mbsbtype |
<mbstring.h> | <mbctype.h>* |
_mbsbtype_l |
<mbstring.h> | <mbctype.h>* |
* Per le costanti manifesto utilizzate come valori restituiti.
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).