mbtowc, _mbtowc_l

Articolo
03/05/2013

Convertire un carattere multibyte a un carattere di tipo corrispondente.

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 di tipo " wide " (tipo wchar_t).
mbchar
indirizzo di una sequenza di byte (un carattere multibyte).
conteggio
Numero di byte da controllare.
impostazioni locali
le impostazioni locali da utilizzare.

Valore restituito

se mbchar non viene NULL e se l'oggetto quello mbchar punti ai form un carattere multibyte valido, mbtowc restituisce la lunghezza in byte di caratteri multibyte.se mbchar viene NULL o l'oggetto a cui punta è un carattere null a caratteri estesi (" \ 0 "), restituisce 0 di funzione.se l'oggetto quello mbchar i punti non costituisce un carattere multibyte valida all'interno del primo conteggio caratteri, restituisce a 1.

Note

mbtowc conversione di funzione conteggio o meno byte operazioni da mbcharse, mbchar non viene NULL, un carattere di tipo corrispondente.mbtowc archivia il carattere di tipo " wide " risultante a wchar, se wchar non viene NULL.mbtowc non esamina più di MB_CUR_MAX byte.mbtowc utilizza le impostazioni locali correnti per il comportamento impostazioni locali-dipendente; _mbtowc_l è identico con la differenza che utilizza le impostazioni locali passate in alternativa.Per ulteriori informazioni, vedere Impostazioni locali.

Requisiti

routine	Intestazione di associazione
mbtowc	<definito>
_mbtowc_l	<definito>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Librerie

Tutte le versioni di Librerie di runtime del linguaggio 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 );
}

Output

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