.\" 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 FPUTWC 3  "25 de julho de 1999" "GNU" "Manual do Programador Linux"
.SH NOME
fputwc \- escreve um caractere largo em um fluxo de arquivo
.SH SINOPSE
.nf
.B #include <stdio.h>
.br
.B #include <wchar.h>
.sp
.BI "wint_t fputwc (wchar_t " wc ", FILE* " stream );
.BI "wint_t putwc (wchar_t " wc ", FILE* " stream );
.fi
.SH DESCRIÇÃO
A função \fBfputwc\fP é o equivalente para caracteres largos da função \fBfputc\fP.
Ela escreve o caractere largo \fIwc\fP em \fIstream\fP. Se 
\fIferror(stream)\fP é verdadeiro, ela retorna WEOF. Se ocorre um erro de conversão
de caractere largo, ele seta \fBerrno\fP para \fBEILSEQ\fP e retorna WEOF.
Caso contrário ela retorna \fIwc\fP.
.PP
A função ou macro \fBputwc\fP funciona de forma idêntica a \fBfputwc\fP.
Ela pode ser implementada como uma macro, e pode avaliar seu argumento mais de uma vez.
Não há razão ainda para usá-la.
.SH "VALOR DE RETORNO"
A função \fBfputwc\fP retorna \fIwc\fP se não ocorreu erro, ou WEOF para indicar um erro.
.SH ERROS
À parte dos erros normais, há
.TP
.B EILSEQ
A conversão de \fIwc\fP para a codificação do fluxo falhou.
.SH "CONFORME"
ISO/ANSI C, UNIX98
.SH "VEJA TAMBÉM"
.BR fgetwc (3),
.BR fputws (3)
.SH NOTAS
O comportamento de \fBfputwc\fP depende da categoria LC_CTYPE do 'locale' corrente.
.PP
Na ausência de informações adicionais passadas para a chamada de 'fopen', é razoável esperar
que \fBfputwc\fP escreverá a sequência multibyte correspondente aos caracteres largos \fIwc\fP.
.SH TRADUÇÃO PARA A LÍNGUA PORTUGUESA
\&\fR\&\f(CWRUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (tradução)\fR
\&\fR\&\f(CWXXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisão)\fR