ferror

FERROR(3)		  Linux Programmer’s Manual		    FERROR(3)



NAME
       clearerr, feof, ferror, fileno - check and reset stream status

SYNOPSIS
       #include <stdio.h>

       void clearerr(FILE *stream);
       int feof(FILE *stream);
       int ferror(FILE *stream);
       int fileno(FILE *stream);

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

       The function feof 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 clearerr.

       The function ferror 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 clearerr function.

       The function fileno examines the argument stream and returns its inte-
       ger descriptor.

       For non-locking counterparts, see unlocked_stdio(3).

ERRORS
       These  functions	 should not fail and do not set the external variable
       errno.  (However, in case fileno detects that its argument  is  not  a
       valid stream, it must return -1 and set errno to EBADF.)

CONFORMING TO
       The  functions  clearerr,  feof,	 and  ferror  conform  to X3.159-1989
       (‘‘ANSI C’’).

SEE ALSO
       open(2), unlocked_stdio(3), stdio(3)



				  2001-10-16			    FERROR(3)