mbtowc, _mbtowc_l

Converte un carattere multibyte in un carattere wide corrispondente.

Sintassi

int mbtowc(
   wchar_t *wchar,
   const char *mbchar,
   size_t count
);
int _mbtowc_l(
   wchar_t *wchar,
   const char *mbchar,
   size_t count,
   _locale_t locale
);

Parametri

wchar
Indirizzo di un carattere wide (tipo wchar_t).

mbchar
Indirizzo di una sequenza di byte (carattere multibyte).

count
Numero di byte da controllare.

locale
Impostazioni locali da usare.

Valore restituito

Se mbchar non NULLè e se mbchar punta a un carattere multibyte valido, mbtowc restituisce la lunghezza in byte del carattere multibyte. Se mbchar è NULL o punta a un carattere Null wide (L'\0'), la funzione restituisce 0. Se l'oggetto che mbchar punta a non forma un carattere multibyte valido all'interno dei primi count caratteri, restituisce -1.

Osservazioni:

La mbtowc funzione converte count o meno byte a cui punta mbchar, se mbchar non NULLè , in un carattere wide corrispondente. mbtowc archivia il carattere wide risultante in corrispondenza di wchar, se wchar non NULLè . mbtowc non esamina più di MB_CUR_MAX byte. mbtowc usa le impostazioni locali correnti per qualsiasi comportamento dipendente dalle impostazioni locali. La funzione _mbtowc_l è identica, ma usa le impostazioni locali passate. Per altre informazioni, vedere Locale.

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
mbtowc	<stdlib.h>
_mbtowc_l	<stdlib.h>

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

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// crt_mbtowc.c
// Illustrates the behavior of the mbtowc function

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

int main( void )
{
    int      i;
    char    *pmbc    = (char *)malloc( sizeof( char ) );
    wchar_t  wc      = L'a';
    wchar_t *pwcnull = NULL;
    wchar_t *pwc     = (wchar_t *)malloc( sizeof( wchar_t ) );
    printf( "Convert a 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 );

    printf( "Convert multibyte character back to a wide "
            "character:\n" );
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "   Bytes converted: %u\n", i );
    printf( "   Wide character: %x\n\n", *pwc );
    printf( "Attempt to convert when target is NULL\n" );
    printf( "   returns the length of the multibyte character:\n" );
    i = mbtowc( pwcnull, pmbc, MB_CUR_MAX );
    printf( "   Length of multibyte character: %u\n\n", i );

    printf( "Attempt to convert a NULL pointer to a" );
    printf( " wide character:\n" );
    pmbc = NULL;
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "   Bytes converted: %u\n", i );
}

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

Convert multibyte character back to a wide character:
   Bytes converted: 1
   Wide character: 61

Attempt to convert when target is NULL
   returns the length of the multibyte character:
   Length of multibyte character: 1

Attempt to convert a NULL pointer to a wide character:
   Bytes converted: 0

Vedi anche

Conversione dei dati
MultiByteToWideChar
impostazioni locali
Interpretazione di sequenze di caratteri multibyte
_mbclen, mblen, _mblen_l
wcstombs, _wcstombs_l
wctomb, _wctomb_l