FERROR(3) BSD Library Functions Manual FERROR(3)

NAME
     cclleeaarreerrrr, cclleeaarreerrrruunnlloocckkeedd, ffeeooff, ffeeooffuunnlloocckkeedd, ffeerrrroorr,
     ffeerrrroorruunnlloocckkeedd, ffiilleennoo, ffiilleennoouunnlloocckkeedd - check and reset stream status

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     void
     cclleeaarreerrrr(FILE *stream);

     void
     cclleeaarreerrrruunnlloocckkeedd(FILE *stream);

     int
     ffeeooff(FILE *stream);

     int
     ffeeooffuunnlloocckkeedd(FILE *stream);

     int
     ffeerrrroorr(FILE *stream);

     int
     ffeerrrroorruunnlloocckkeedd(FILE *stream);

     int
     ffiilleennoo(FILE *stream);

     int
     ffiilleennoouunnlloocckkeedd(FILE *stream);

DESCRIPTION
     The function cclleeaarreerrrr() clears the end-of-file and error indicators for
     the stream pointed to by stream.

     The function ffeeooff() tests the end-of-file indicator for the stream
     pointed to by stream, returning non-zero if it is set.  The end-of-file
     indicator can only be cleared by the function cclleeaarreerrrr().

     The function ffeerrrroorr() tests the error indicator for the stream pointed to
     by stream, returning non-zero if it is set.  The error indicator can only
     be reset by the cclleeaarreerrrr() function.

     The function ffiilleennoo() examines the argument stream and returns its inte-
     ger descriptor.

     The cclleeaarreerrrruunnlloocckkeedd(), ffeeooffuunnlloocckkeedd(), ffeerrrroorruunnlloocckkeedd(), and
     ffiilleennoouunnlloocckkeedd() functions are equivalent to cclleeaarreerrrr(), ffeeooff(),
     ffeerrrroorr(), and ffiilleennoo() respectively, except that the caller is responsi-
     ble for locking the stream with flockfile(3) before calling them.  These
     functions may be used to avoid the overhead of locking the stream and to
     prevent races when multiple threads are operating on the same stream.

EERRRROORRSS
     These functions should not fail and do not set the external variable
     errno.

SEE ALSO
     open(2), fdopen(3), flockfile(3), stdio(3)

STANDARDS     The functions cclleeaarreerrrr(), ffeeooff(), and ffeerrrroorr() conform to ISO/IEC
     9899:1990 (``ISO C90'').

BSD                            January 10, 2003                            BSD