ferror(3) Library Functions Manual ferror(3) NOME clearerr, feof, ferror - verifica e redefine estado de um fluxo BIBLIOTECA Standard C library (libc, -lc) SINOPSE #include void clearerr(FILE *fluxo); int feof(FILE *fluxo); int ferror(FILE *fluxo); DESCRICAO A funcao clearerr() limpa os indicadores de fim de arquivo (eof) e de erro para o fluxo. A funcao feof() testa o indicador de fim de arquivo para o fluxo apontado por fluxo, retornando um valor diferente de zero se estiver definido. O indicador de fim de arquivo somente pode ser desligado apenas pela funcao clearerr(). A funcao ferror() testa o indicador de erro para o o fluxo apontado por fluxo, retornando um valor diferente de zero se estiver definido. O indicador de erro somente pode ser redefinido apenas pela funcao clearerr(). Para contrapartes nao bloqueantes, veja unlocked_stdio(3). VALOR DE RETORNO A funcao feof() retorna diferente de zero se o indicador de fim de arquivo estiver definido para fluxo; caso contrario, retorna zero. A funcao ferror() retorna diferente de zero se o indicador de erro estiver definido para fluxo; caso contrario, retorna zero. ERROS Estas funcoes nao devem falhar e nao definem errno. ATRIBUTOS Para uma explicacao dos termos usados nesta secao, consulte attributes(7). +--------------------------------------------+---------------+---------+ |Interface | Atributo | Valor | +--------------------------------------------+---------------+---------+ |clearerr(), feof(), ferror() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ PADROES C11, POSIX.1-2008. HISTORICO C89, POSIX.1-2001. NOTAS POSIX.1-2008 especifica que essas funcoes nao devem alterar o valor de errno se fluxo for valido. RESSALVAS Normalmente, os programas devem ler o valor de retorno de uma funcao de entrada, como fgetc(3), antes de usar funcoes da familia feof(3). Somente quando a funcao retorna o valor sentinela EOF faz sentido distinguir entre o fim de um arquivo ou um erro com feof(3) ou ferror(3). VEJA TAMBEM open(2), fdopen(3), fileno(3), stdio(3), unlocked_stdio(3) TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Felipe M Pereira , Andre Luiz Fassone e Rafael Fontenelle . Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . Linux man-pages 6.12 23 julho 2024 ferror(3)