.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Translated Sun Apr 23 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH BTOWC 3  "25 julio 1999" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
btowc \- convierte un único byte en un carácter ancho
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "wint_t btowc (int " c );
.fi
.SH DESCRIPCIÓN
La función \fBbtowc\fP convierte \fIc\fP, 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 \fIc\fP es EOF o no es una
secuencia multibyte válida de longitud 1, la función \fBbtowc\fP devuelve
WEOF.
.SH "VALOR DEVUELTO"
La función \fBbtowc\fP devuelve el carácter ancho obtenido del único byte
\fIc\fP. Si \fIc\fP es EOF o no es una secuencia multibyte válida de
longitud 1, devuelve WEOF.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VÉASE TAMBIÉN"
.BR mbtowc (3)
.SH OBSERVACIONES
El comportamiento de \fBbtowc\fP depende de la categoría LC_CTYPE de la
localización actual.
.PP
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 \fBmbtowc\fP.