mbtowc, _mbtowc_l

Převede vícebajtový znak na odpovídající široký znak.

Syntaxe

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
);

Parametry

wchar
Adresa širokého znaku (typu wchar_t).

mbchar
Adresa posloupnosti bajtů (vícebajtový znak).

count
Počet bajtů, které chcete zkontrolovat.

locale
Národní prostředí, které se má použít

Vrácená hodnota

Pokud mbchar není NULL, a pokud mbchar odkazuje na platný vícebajtový znak, mbtowc vrátí délku v bajtech vícebajtového znaku. Pokud mbchar je NULL nebo odkazuje na znak null širokého znaku (L'\0'), vrátí funkce hodnotu 0. Pokud objekt, na který mbchar odkazuje, neformuje platný vícebajtový znak v rámci prvních count znaků, vrátí hodnotu -1.

Poznámky

Funkce mbtowc převede count nebo méně bajtů, na které mbcharodkazuje , pokud mbchar není NULL, na odpovídající široký znak. mbtowc uloží výsledný široký znak na wchar, pokud wchar není NULL. mbtowc nezkoumá více než MB_CUR_MAX bajty. mbtowc používá aktuální národní prostředí pro chování závislé na národním prostředí; _mbtowc_l je shodný s tím rozdílem, že místo toho používá národní prostředí předané. Další informace naleznete v tématu Národní prostředí.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Všechny verze knihoven runtime jazyka C.

Příklad

// 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

Viz také

Konverze dat
MultiByteToWideChar
Národní prostředí
Interpretace vícebajtových sekvencí znaků
_mbclen, , mblen_mblen_l
wcstombs, _wcstombs_l
wctomb, _wctomb_l