.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" and Copyright (C) 2021 Michael Kerrisk <mtk.manpages@gmail.com>
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Chris Torek and the American National Standards Committee X3,
.\" on Information Processing Systems.
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"     @(#)ferror.3	6.8 (Berkeley) 6/29/91
.\"
.\"
.\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ferror 3 "23 julho 2024" "Linux man\-pages 6.12" 
.SH NOME
clearerr, feof, ferror \- verifica e redefine estado de um fluxo
.SH BIBLIOTECA
Standard C library (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <stdio.h>\fP
.P
\fBvoid clearerr(FILE *\fP\fIfluxo\fP\fB);\fP
\fBint feof(FILE *\fP\fIfluxo\fP\fB);\fP
\fBint ferror(FILE *\fP\fIfluxo\fP\fB);\fP
.fi
.SH DESCRIÇÃO
A função \fBclearerr\fP() limpa os indicadores de fim de arquivo (eof) e de
erro para o \fIfluxo\fP.
.P
A função \fBfeof\fP() testa o indicador de fim de arquivo para o fluxo apontado
por \fIfluxo\fP, retornando um valor diferente de zero se estiver definido. O
indicador de fim de arquivo somente pode ser desligado apenas pela função
\fBclearerr\fP().
.P
A função \fBferror\fP() testa o indicador de erro para o o fluxo apontado por
\fIfluxo\fP, retornando um valor diferente de zero se estiver definido. O
indicador de erro somente pode ser redefinido apenas pela função
\fBclearerr\fP().
.P
Para contrapartes não bloqueantes, veja \fBunlocked_stdio\fP(3).
.SH "VALOR DE RETORNO"
A função \fBfeof\fP() retorna diferente de zero se o indicador de fim de
arquivo estiver definido para \fIfluxo\fP; caso contrário, retorna zero.
.P
A função \fBferror\fP() retorna diferente de zero se o indicador de erro
estiver definido para \fIfluxo\fP; caso contrário, retorna zero.
.SH ERROS
Estas funções não devem falhar e não definem \fIerrno\fP.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBclearerr\fP(),
\fBfeof\fP(),
\fBferror\fP()
T}	Thread safety	MT\-Safe
.TE
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
C89, POSIX.1\-2001.
.SH NOTAS
.\"https://www.austingroupbugs.net/view.php?id=401
POSIX.1\-2008 especifica que essas funções não devem alterar o valor de
\fIerrno\fP se \fIfluxo\fP for válido.
.SH RESSALVAS
Normalmente, os programas devem ler o valor de retorno de uma função de
entrada, como \fBfgetc\fP(3), antes de usar funções da família
\fBfeof\fP(3). Somente quando a função retorna o valor sentinela \fBEOF\fP faz
sentido distinguir entre o fim de um arquivo ou um erro com \fBfeof\fP(3) ou
\fBferror\fP(3).
.SH "VEJA TAMBÉM"
\fBopen\fP(2), \fBfdopen\fP(3), \fBfileno\fP(3), \fBstdio\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>,
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 .