ferror

Testa um erro em um fluxo.

Sintaxe

int ferror(
   FILE *stream
);

Parâmetros

stream
Ponteiro para a estrutura FILE.

Valor retornado

Se nenhum erro tiver ocorrido em stream, ferror retornará 0. Caso contrário, retornará um valor diferente de zero. Se stream for NULL, ferror invocará o manipulador de parâmetro inválido, 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, confira Estado global no CRT.

Requisitos

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