wctob

Artigo
06/09/2015

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 a ser convertida.

Valor de retorno

Se wctob converte com êxito um caractere largo, retorna sua representação de caracteres multibyte, apenas se o caracteres multibyte é exatamente um byte por muito tempo. Se wctob encontrar um caractere largo que não pode converter em um caracteres multibyte ou o caracteres multibyte não é exatamente um byte por muito tempo, retorna A-1.

Comentários

A função de wctob converte um caractere largo contido em wchar correspondente em caracteres multibyte passado pelo valor de retorno de int , se o caracteres multibyte é exatamente um byte por muito tempo.

Se wctob não foi bem-sucedida e nenhum caractere correspondente multibyte foi localizado, a função errno define a EILSEQ e retorna -1.

Requisitos

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

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

Esse programa ilustra o comportamento da função de wcstombs .

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