wctob

Artigo
08/25/2010

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

If wctob Converte com êxito um caractere largo, retornará sua representação de caracteres multibyte, somente se os caracteres multibyte for exatamente um byte. If wctob encontrar um caractere largo não pode converter em um caractere de vários bytes ou caracteres multibyte não é exatamente um byte de comprimento, que ele retorna um – 1.

Comentários

The wctob função converte um caractere largo contido em wchar o caractere multibyte correspondente passados pelo retorno int valor, se os caracteres multibyte for exatamente um byte.

If wctob não foi bem-sucedida e sem caractere 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 compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Este programa ilustra o comportamento do 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);
    }
}

Determined the corresponding multibyte character to be "A".