wctob

Určuje, zda široký znak odpovídá vícebajtovém znaku a vrátí jeho vícebajtové vyjádření znaku.

Syntaxe

int wctob(
   wint_t wchar
);

Parametry

wchar
Hodnota, která se má přeložit

Vrácená hodnota

Pokud wctob se úspěšně převede široký znak, vrátí vícebajtové vyjádření znaku pouze v případě, že vícebajtový znak je jeden bajt dlouhý. Pokud wctob narazí na široký znak, nemůže se převést na vícebajtový znak nebo pokud vícebajtový znak není jeden bajt dlouhý, vrátí hodnotu -1.

Poznámky

Funkce wctob převede široký znak obsažený na wchar odpovídající vícebajtový znak předaný int návratovou hodnotou, pokud je vícebajtový znak jeden bajt dlouhý.

Pokud wctob nebyly nalezeny žádné odpovídající vícebajtové znaky, funkce nastaví errnoEILSEQ hodnotu -1 a vrátí hodnotu -1.

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

Rutina	Požadovaný hlavičkový soubor
wctob	<wchar.h>

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

Příklad

Tento program znázorňuje chování wctob funkce.

// crt_wctob.c
#include <stdio.h>
#include <wchar.h>

int main( void )
{
    int     bChar = 0;
    wint_t  wChar = 0;

    // Set the corresponding wide character to exactly one byte.
    wChar = (wint_t)'A';

    bChar = wctob( wChar );
    if (bChar == WEOF)
    {
        printf( "No corresponding multibyte character was found.\n");
    }
    else
    {
        printf( "Determined the corresponding multibyte character to"
                " be \"%c\".\n", bChar);
    }
}

Determined the corresponding multibyte character to be "A".

Viz také

Převod dat
Národní prostředí
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte