fpurge, __fpurge - purge a stream
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────┬───────────────┬─────────────────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────┼───────────────┼─────────────────────┤
│ __fpurge() │ Thread safety │ MT-Safe race:stream │
└─────────────────────────────────────────────────────────────────┴───────────────┴─────────────────────┘
Description
The function fpurge() clears the buffers of 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(3). See also fflush(3).
The function __fpurge() does precisely the same, but without returning a value.
Errors
EBADFstream is not an open stream.
History
fpurge()
4.4BSD. Not available under Linux.
__fpurge()
Solaris, glibc 2.1.95.
Library
Standard C library (libc, -lc)
Name
fpurge, __fpurge - purge a stream
Notes
Usually it is a mistake to want to discard input buffers.
Return Value
Upon successful completion fpurge() returns 0. On error, it returns -1 and sets errno to indicate the
error.
See Also
fflush(3), setbuf(3), stdio_ext(3) Linux man-pages 6.9.1 2024-05-02 fpurge(3)
Standards
None.
Synopsis
/* unsupported */
#include<stdio.h>intfpurge(FILE*stream);
/* supported */
#include<stdio.h>#include<stdio_ext.h>void__fpurge(FILE*stream);