FFLUSH(3)                      Library Routines                      FFLUSH(3)




NAME

       fflush, fpurge - flush a stream


SYNOPSIS

       #include <stdio.h>

       int fflush (FILE *stream);
       int fpurge (FILE *stream);


DESCRIPTION

       The  function  fflush forces a write of all buffered data for the given
       output or update stream via the  stream's  underlying  write  function.
       The open status of the stream is unaffected.

       If the stream argument is NULL, fflush flushes all open output streams.

       The function fpurge erases any input or output buffered  in  the  given
       stream.   For  output  streams this discards any unwritten output.  For
       input streams this discards any input read from the  underlying  object
       but  not  yet  obtained via getc(3); this includes any text pushed back
       via ungetc.


RETURN VALUES

       Upon successful completion 0 is returned.  Otherwise, EOF  is  returned
       and the global variable errno is set to indicate the error.


ERRORS

              EBADF  Stream  is not an open stream, or, in the case of fflush,
                     not a stream open for writing.

       The function fflush may also fail and set errno for any of  the  errors
       specified for the routine write(2).


SEE ALSO

       write(2), fopen(3), fclose(3), setbuf(3)


STANDARDS

       The fflush function conforms to ANSI/C.



GNO                            15 September 1997                     FFLUSH(3)

Man(1) output converted with man2html