_mbclen, mblen, _mblen_l_mbclen_l

Ottiene la lunghezza e determina la validità di un carattere multibyte.

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

size_t _mbclen(
   const unsigned char *c
);
size_t _mbclen_l(
   unsigned char const* c,
   _locale_t locale
);
int mblen(
   const char *mbstr,
   size_t count
);
int _mblen_l(
   const char *mbstr,
   size_t count,
   _locale_t locale
);

Parametri

c
Carattere multibyte.

mbstr
Indirizzo di una sequenza di byte del carattere multibyte.

count
Numero di byte da controllare.

locale
Impostazioni locali da usare.

Valore restituito

_mbclen e _mbclen_l restituiscono 1 o 2, in base alla lunghezza del carattere cmultibyte . Le funzioni restituiscono sempre 1 per UTF-8, indipendentemente dal fatto che c sia multibyte o meno. Non viene restituito alcun errore per _mbclen.

Se mbstr non NULLè e mblen _mblen_l restituisce la lunghezza, in byte, del carattere multibyte. Le mblen funzioni e _mblen_l funzionano correttamente in UTF-8 e possono restituire un valore compreso tra 1 e 3. Quando mbstr è NULL (o punta al carattere null wide) mblen e _mblen_l restituisce 0. L'oggetto che mbstr punta a deve formare un carattere multibyte valido all'interno dei primi count caratteri o mblen _mblen_l restituire -1.

Osservazioni:

La funzione _mbclen restituisce la lunghezza in byte del carattere multibyte c. Se c non punta al byte iniziale di un carattere multibyte (come determinato da una chiamata implicita a _ismbblead, il risultato di _mbclen è imprevedibile.

mblen restituisce la lunghezza in byte di mbstr se è un carattere multibyte valido. Determina inoltre la validità dei caratteri multibyte associata alla tabella codici. mblen esamina count o un numero inferiore di byte contenuti in mbstr, ma non più di MB_CUR_MAX byte.

Il valore di output è interessato dall'impostazione LC_CTYPE di categoria delle impostazioni locali. Le versioni di queste funzioni senza il _l suffisso usano le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali. Le _l versioni con suffisso si comportano allo stesso modo, ma usano il parametro delle impostazioni locali passato. Per altre informazioni, vedere setlocale e Impostazioni locali.

_mbclen, _mblen_le _mbclen_l sono specifici di Microsoft, non fanno parte della libreria C standard. Non è consigliabile usarli dove si vuole il codice portatile. Per la compatibilità C standard, usare mblen o mbrlen .

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
_tclen	Mapping a una macro o a una funzione inline	_mbclen	Mapping a una macro o a una funzione inline

Requisiti

Ciclo	Intestazione obbligatoria
_mbclen	<mbstring.h>
mblen	<stdlib.h>
_mblen_l	<stdlib.h>

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

Esempio

// crt_mblen.c
/* illustrates the behavior of the mblen function
*/

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *pmbc = (char *)malloc( sizeof( char ) );
    wchar_t  wc   = L'a';

    printf( "Convert wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "   Characters converted: %u\n", i );
    printf( "   Multibyte character: %x\n\n", *pmbc );

    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of multibyte character %x: %u\n", *pmbc, i );

    pmbc = NULL;
    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of NULL multibyte character %x: %u\n", pmbc, i );
}

Convert wide character to multibyte character:
   Characters converted: 1
   Multibyte character: 61

Length in bytes of multibyte character 61: 1
Length in bytes of NULL multibyte character 0: 0

Vedi anche

Classificazione dei caratteri
impostazioni locali
Interpretazione di sequenze di caratteri multibyte
_mbccpy, _mbccpy_l
mbrlen
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen_mbstrlen_l