NOMBRE

       btowc - convierte un único byte en un carácter ancho

SINOPSIS

       #include <wchar.h>

       wint_t btowc (int c);

DESCRIPCIÓN

       La  función btowc convierte c, interpretado como una sequencia multibyte de longitud 1 que
       comienza en el estado de cambio inicial, a un carácter ancho, devolviendo el resultado. Si
       c  es  EOF o no es una secuencia multibyte válida de longitud 1, la función btowc devuelve
       WEOF.

VALOR DEVUELTO

       La función btowc devuelve el carácter ancho obtenido del único byte c. Si c es EOF o no es
       una secuencia multibyte válida de longitud 1, devuelve WEOF.

CONFORME A

       ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       mbtowc(3)

OBSERVACIONES

       El comportamiento de btowc depende de la categoría LC_CTYPE de la localización actual.

       Esta  función  no  debería  usarse  nunca.  No  funciona  para codificaciones con estado e
       innecesariamente trata bytes únicos de forma diferente de las secuencias multibyte. En  su
       lugar, use la función mbtowc.