NAME

ferror — test error indicator on a stream

SYNOPSIS

#include <stdio.h>

int ferror(FILE *stream);


DESCRIPTION

^[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2024 defers to the ISO C standard.

The ferror() function shall test the error indicator for the stream pointed to by stream.

^[CX] The ferror() function shall not change the setting of errno if stream is valid.

RETURN VALUE

The ferror() function shall return non-zero if and only if the error indicator is set for stream.

ERRORS

No errors are defined.

EXAMPLES

None.

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

clearerr , feof , fopen

XBD <stdio.h>

CHANGE HISTORY

First released in Issue 1. Derived from Issue 1 of the SVID.

Issue 7

POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0125 [401] is applied.