wctob

Determina se um caractere largo corresponde a um caractere multibyte e retorna sua representação de caracteres multibyte.

Sintaxe

int wctob(
   wint_t wchar
);

Parâmetros

wchar
A valor a ser movido.

Valor retornado

Se wctob converter com êxito um caractere largo, ele retornará sua representação de caractere multibyte somente se o caractere multibyte tiver um único byte de comprimento. Se wctob encontrar um caractere largo, ele não poderá converter em um caractere multibyte ou, se o caractere multibyte não tiver um único byte, ele retornará -1.

Comentários

A wctob função converte um caractere largo contido no wchar caractere multibyte correspondente passado pelo int valor retornado, se o caractere multibyte tiver um único byte de comprimento.

Se wctob não for bem-sucedido e nenhum caractere multibyte correspondente for encontrado, a função definirá errno como EILSEQ e retornará –1.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Este programa ilustra o comportamento da função wctob.

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

Confira também

Conversão de dados
Localidade
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte