wctob

Determina si un carácter ancho se corresponde con un carácter multibyte y devuelve su representación de carácter multibyte.

Sintaxis

int wctob(
   wint_t wchar
);

Parámetros

wchar
Valor que se va a traducir.

Valor devuelto

Si wctob convierte correctamente un carácter ancho, devuelve su representación de caracteres multibyte solo si el carácter multibyte es un solo byte long. Si wctob encuentra un carácter ancho, no puede convertir en un carácter multibyte, o si el carácter multibyte no es un solo byte long, devuelve -1.

Comentarios

La wctob función convierte un carácter ancho contenido en wchar en el carácter multibyte correspondiente pasado por el int valor devuelto, si el carácter multibyte es un solo byte long.

Si wctob no se ha realizado correctamente y no se ha encontrado ningún carácter multibyte correspondiente, la función establece errno en EILSEQ y devuelve -1.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
wctob	<wchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

Este programa muestra el comportamiento de la función 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".

Consulte también

Conversión de datos
Configuración regional
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte