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 ALSOfpurge 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)
