dwww Home | Manual pages | Find package

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

       ┌────────────────────────────────┬───────────────┬─────────────────────┐
       │InterfaceAttributeValue               │
       ├────────────────────────────────┼───────────────┼─────────────────────┤
       │__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.