.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" 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.
.\" %%%LICENSE_END
.\"
.\" 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
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH BTOWC 3 "8 Agosto 2015" GNU "Manual del Programador de Linux"
.SH NOMBRE
btowc \- convierte un único byte en un carácter ancho
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBwint_t btowc(int \fP\fIc\fP\fB);\fP
.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 \fBEOF\fP o no es una
secuencia multibyte válida de longitud 1, la función \fBbtowc\fP() devuelve
\fBWEOF\fP.
.SH "VALOR DEVUELTO"
La función \fBbtowc\fP() devuelve el carácter ancho obtenido del único byte
\fIc\fP. Si \fIc\fP es \fBEOF\fP o no es una secuencia multibyte válida de longitud
1, devuelve \fBWEOF\fP.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBbtowc\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.SH "CONFORME A"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
El comportamiento de \fBbtowc\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.PP
This function should never be used.  It does not work for encodings which
have state, and unnecessarily treats single bytes differently from multibyte
sequences.  Use either \fBmbtowc\fP(3)  or the thread\-safe \fBmbrtowc\fP(3)
instead.
.SH "VÉASE TAMBIÉN"
\fBmbrtowc\fP(3), \fBmbtowc\fP(3), \fBwctob\fP(3)
.SH COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux
\fIman\-pages\fP. Puede encontrar una descripción del proyecto, información
sobre cómo informar errores y la última versión de esta página en
\%https://www.kernel.org/doc/man\-pages/.
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Juan Piernas <piernas@ditec.um.es>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .