.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" 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 fwide 3 "30 março 2023" "Linux man\-pages 6.05.01" 
.SH NOME
fwide \- seleciona e determina a orientação do fluxo de arquivo
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <wchar.h>\fP
.PP
\fBint fwide(FILE *\fP\fIfluxo\fP\fB, int \fP\fImodo\fP\fB);\fP
.fi
.PP
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.PP
\fBfwide\fP():
.nf
    _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE
        || _POSIX_C_SOURCE >= 200112L
.fi
.SH DESCRIÇÃO
Quando \fImodo\fP é zero, a função \fBfwide\fP() determina a orientação atual do
\fIfluxo\fP. Ela retorna um valor positivo se o \fIfluxo\fP é orientado a
caracteres largos, isto é, se E/S de caracteres largos é permitido, mas E/S
de caracteres está desabilitado. Ela retorna um valor negativo se o \fIfluxo\fP
é orientado a byte, isto é, se E/S de caracteres é permitido, mas E/S de
caracteres largos está desabilitado. Ela retorna zero se o \fIfluxo\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 \fImodo\fP é diferente de zero, a função \fBfwide\fP() primeiro tenta
definir a orientação do \fIfluxo\fP (para orientado a caractere largo se
\fImodo\fP for maior que 0, ou para orientado a byte se \fImodo\fP for menor que
0). Ela retorna um valor denotando a orientação atual, 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 positivo significa orientação a caracteres
largos. Um valor de retorno negativo significa orientação a byte. Um valor
de retorno significa indecisão.
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
POSIX.1\-2001, C99.
.SH NOTAS
Saída de caracteres largos para um fluxo orientado a byte pode ser realizado
através da função \fBfprintf\fP(3) com as diretivas \fB%lc\fP e \fB%ls\fP.
.PP
Saída orientada a caracteres para um fluxo orientado a caracteres largos
pode ser realizado através da função \fBfwprintf\fP(3) com as diretivas \fB%c\fP e
\fB%s\fP.
.SH "VEJA TAMBÉM"
\fBfprintf\fP(3), \fBfwprintf\fP(3)
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Rubens de Jesus Nogueira <darkseid99@usa.net>,
André Luiz Fassone <lonely_wolf@ig.com.br>
e
Rafael Fontenelle <rafaelff@gnome.org>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .