.\" 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 FWIDE 3  "17 de novembro de 1999" "GNU" "Manual do Programador Linux"
.SH NOME
fwide \- seta e determina a orientação do fluxo de arquivo
.SH SINOPSE
.nf
.B #include <wchar.h>
.sp
.BI "int fwide (FILE* " stream ", int " mode );
.fi
.SH DESCRIÇÃO
Quando \fImode\fP é zero, a função \fBfwide\fP determina a orientação corrente
de \fIstream\fP. Ela retorna um valor > 0 se \fIstream\fP é orientado a caracteres
largos, isto é, se E/S de caracteres largos é permitido mas E/S de caracteres está
desabilitado. Ela retorna um valor < 0 se \fIstream\fP é orientado a byte, isto é,
se E/S de caracteres é permitido mas E/S de caracteres largos está desabilitado. Ela
retorna zero se \fIstream\fP ainda não tem orientação; neste caso, a próxima operação
de E/S pode mudar a orientação (para orientado a byte se for uma operação de E/S de 
caractere, ou para orientado a caracteres largos se for uma operação de E/S para 
caracteres largos).
.PP
Uma vez que um fluxo tem uma orientação, ele não pode ser mudado e persiste até que 
o fluxo seja fechado.
.PP
Quando \fImode\fP é diferente de zero, a função \fBfwide\fP primeiro tenta setar a
orientação de \fIstream\fP (para orientado a caractere largo se \fImode\fP > 0, ou
para orientado a byte se \fImode\fP < 0). Ela retorna um valor denotando a orientação
corrente, como visto acima.
.SH "VALOR DE RETORNO"
A função \fBfwide\fP retorna a orientação do fluxo, depois de possivelmente mudá-la.
Um valor de retorno > 0 significa orientação a caracteres largos. Um valor de retorno
< 0 significa orientação a byte. Um valor de retorno significa indecisão.
.SH "CONFORME"
ISO/ANSI C, UNIX98
.SH "VEJA TAMBÉM"
.BR fprintf "(3), " fwprintf (3)
.SH NOTAS
Saída de caracteres largos para um fluxo orientado a byte pode ser realizado através da
função \fBfprintf\fP com as diretivas %lc e %ls.
.PP
Saída orientada a caracteres para um fluxo orientado a caracteres largos pode ser realizado
através da função \fBfwprintf\fP com as diretivas %c e %s.
.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