FPURGE
Section: Misc. Reference Manual Pages (3bsd)
Page Index
BSD mandoc
NAME
fpurge
- flush a stream
LIBRARY
Lb libbsd
SYNOPSIS
In stdio.h
(See
libbsd(7)
for include usage.)
Ft int
Fn fpurge FILE *stream
DESCRIPTION
The function
Fn fpurge
erases any input or output buffered in the given
Fa 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(3).
RETURN VALUES
Upon successful completion 0 is returned.
Otherwise,
EOF
is returned and the global variable
errno
is set to indicate the error.
ERRORS
- Bq Er EBADF
-
Fa stream
is not an open stream.
SEE ALSO
fclose(3),
fopen(3),
setvbuf(3)
HISTORY
The
Fn fpurge
function first appeared in
BSD 4.4 Lite