FPURGE(3)

NAME
4.19 `fpurge'--discard pending file I/O

SYNOPSIS
     #include <stdio.h>
     int fpurge(FILE *FP);
     int _fpurge_r(struct _reent *REENT, FILE *FP);

DESCRIPTION
Use `fpurge' to clear all buffers of the given stream. For output streams, this discards data not yet written to disk. For input streams, this discards any data from `ungetc' and any data retrieved from disk but not yet read via `getc'. This is more severe than `fflush', and generally is only needed when manually altering the underlying file descriptor of a stream.
   The alternate function `_fpurge_r' is a reentrant version, where the extra argument REENT is a pointer to a reentrancy structure, and FP must not be NULL.

RETURNS
`fpurge' returns `0' unless FP is not valid, in which case it returns `EOF' and sets `errno'.

PORTABILITY
These functions are not portable to any standard.
   No supporting OS subroutines are required.

SEE ALSO
fpurge is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.