.\" 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
.\"
.TH BTOWC 3  "July 25, 1999" "GNU" "Linux Programmer's Manual"
.SH NOME
btowc \- converte um byte para um caracter largo
.SH SINOPSE
.nf
.B #include <wchar.h>
.sp
.BI "wint_t btowc (int " c );
.fi
.SH DESCRIÇÃO
A função \fBbtowc\fP converte \fIc\fP, tratada como uma seqüência de bytes de
comprimento 1, começando no shift state inicial, para um caracter completo e o retorna.
Se \fIc\fP for EOF ou não for uma seqüencia de comprimento 1 válida, retorna WEOF.
.SH "VALOR RETORNADO"
A função \fBbtowc\fP retorna o caracter completo gerado a partir do byte \fIc\fP.
Se \fIc\fP for EOF ou não for uma seqüência de comprimento 1 válida, retorna WEOF.
.SH "DE ACORDO COM"
ISO/ANSI C, UNIX98
.SH "SEE ALSO"
.BR mbtowc (3)
.SH OBSERVAÇÕES
O comportamento desta função depende do LC_TYPE atual.
.PP
Esta função não deve nunca ser usada. Ela não funciona para codificações que
têm estado, e trata bytes únicos como seqüências de vários bytes desnecessariamente.
Use a função \fBmbtowc\fP.
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWPaulo César Mendes <drpc@ism.com.br> (tradução)\fR
\&\fR\&\f(CWxxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)\fR