fpurge(3) Library Functions Manual fpurge(3) NAME fpurge, __fpurge - purge a stream LIBRARY Standard C library (libc, -lc) SYNOPSIS /* unsupported */ #include <stdio.h> int fpurge(FILE *stream); /* supported */ #include <stdio.h> #include <stdio_ext.h> void __fpurge(FILE *stream); DESCRIPTION The function fpurge() clears the buffers of the given stream. For out- put 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. RETURN VALUE Upon successful completion fpurge() returns 0. On error, it returns -1 and sets errno to indicate the error. ERRORS EBADF stream is not an open stream. ATTRIBUTES For an explanation of the terms used in this section, see at- tributes(7). ┌────────────────────────────────┬───────────────┬─────────────────────┐ │Interface │ Attribute │ Value │ ├────────────────────────────────┼───────────────┼─────────────────────┤ │__fpurge() │ Thread safety │ MT-Safe race:stream │ └────────────────────────────────┴───────────────┴─────────────────────┘ STANDARDS These functions are nonstandard and not portable. The function fpurge() was introduced in 4.4BSD and is not available under Linux. The function __fpurge() was introduced in Solaris, and is present in glibc 2.1.95 and later. NOTES Usually it is a mistake to want to discard input buffers. SEE ALSO fflush(3), setbuf(3), stdio_ext(3) Linux man-pages 6.03 2022-12-15 fpurge(3)
Generated by dwww version 1.15 on Sun Jun 16 18:35:06 CEST 2024.