FPURGE(3) NEWLIB 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 main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 FPURGE(3)