_mbsbtype, _mbsbtype_l
Restituisce il tipo di byte all'interno di una stringa.
.gif "Nota importante") Importante |
|---|
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW. |
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 dei byte dall'inizio della stringa.locale
Impostazioni locali da utilizzare.
Valore restituito
_mbsbtype e _mbsbtype_lrestituisce un numero intero che indica il risultato del test in byte specificato.Le costanti manifesto nella tabella seguente sono definite in Mbctype.h.
Valore restituito |
Tipo byte. |
|---|---|
_MBC_SINGLE (0) |
Carattere a byte singolo.Ad esempio, nella tabella codici 932, _mbsbtype restituisce 0 se il byte specificato è compreso nell'intervallo 0x20 – 0x7E o 0xA1 – 0xDF. |
_MBC_LEAD (1) |
Byte iniziale del carattere multibyte.Ad esempio, nella tabella codici 932, _mbsbtype restituisce 1 se il byte specificato è compreso nell'intervallo 0x81 – 0x9F o 0xE0 – 0xFC. |
_MBC_TRAIL (2) |
Byte finale del carattere multibyte.Ad esempio, nella tabella codici 932, _mbsbtype restituisce 2 se il byte specificato è compreso nell'intervallo 0x40 – 0x7E or 0x80 – 0xFC. |
_MBC_ILLEGAL (–1) |
Stringa NULL, carattere non valido, o byte NULL trovati prima del byte all'offset count in mbstr. |
Note
La funzione _mbsbtype determina il tipo di un byte in una stringa di caratteri multibyte.La funzione esamina solo il byte all'offset count in mbstr, i caratteri non validi prima del byte specificato verranno ignorati.
Il valore di output è interessato dall'impostazione dell'impostazione di categoria LC_CTYPE delle impostazioni locali; vedere setlocale per ulteriori informazioni.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 che viene passato.Per ulteriori informazioni, vedere Impostazioni locali.
Se la stringa di input è NULL, verrà richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri.Se l'esecuzione può continuare, errno viene impostato su EINVAL e la funzione restituisce _MBC_ILLEGAL.
Requisiti
Routine |
Intestazione obbligatoria |
Intestazione facoltativa |
|---|---|---|
_mbsbtype |
<mbstring.h> |
<mbctype.h>* |
_mbsbtype_l |
<mbstring.h> |
<mbctype.h>* |
* Per le costanti manifesto utilizzate come valori restituiti.
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Equivalente .NET Framework
Non applicabile, vedere System::Globalization::CultureInfo.