ferror

Testa um erro em um fluxo.

Sintaxe

int ferror(
   FILE *stream
);

Parâmetros

stream
Ponteiro para a estrutura FILE.

Retornar valor

Se nenhum erro tiver ocorrido em stream, ferror retornará 0. Caso contrário, retornará um valor diferente de zero. Se stream for NULL, invocará o manipulador de parâmetros inválido, ferror conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, essa função define errno como EINVAL e retorna 0.

Para obter mais informações sobre códigos de retorno, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

Os testes de rotina ferror (implementados como uma função e como uma macro) para leitura ou gravação de erro no arquivo associado a stream. Se tiver ocorrido um erro, o indicador de erro para o fluxo permanecerá definido até que o fluxo seja fechado ou rebobinado ou até clearerr ser chamado.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Função	Cabeçalho necessário
ferror	<stdio.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Confira o exemplo de feof.

Confira também

Tratamento de erros
E/S de fluxo
clearerr
_eof
feof
fopen, _wfopen
perror, _wperror