wctob

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

int wctob(
   wint_t wchar
);

Parâmetros

wchar
Valor para traduzir.

Valor de retorno

Se wctob com êxito, converte um caractere largo, ele retorna sua representação de caracteres multibyte, somente se os caracteres multibyte é exatamente um byte.Se wctob encontra um caractere largo, ele não é possível converter um caractere de multibyte ou os caracteres multibyte não é exatamente um byte, long, ele retorna um – 1.

Comentários

O wctob função converte um caractere largo contido no wchar para os caracteres multibyte correspondente passados pelo retorno int valor, se os caracteres multibyte é exatamente um byte.

Se wctob não foi bem-sucedida e sem caracteres multibyte correspondente foi encontrado, a função define errno para EILSEQ e retorna -1.

Requisitos

Rotina	Cabeçalho necessário
wctob	<wchar.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

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

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