GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:fpurge

FPURGE(3) Linux Programmer's Manual FPURGE(3)

NAME

     fpurge, __fpurge - purge a stream

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

ERRORS

     EBADF  stream is not an open stream.

ATTRIBUTES

     For   an   explanation   of   the  terms  used  in  this  section,  see
     attributes(7).
     +-----------+---------------+---------------------+
     |Interface  | Attribute     | Value               |
     +-----------+---------------+---------------------+
     |__fpurge() | Thread safety | MT-Safe race:stream |
     +-----------+---------------+---------------------+

CONFORMING TO

     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)

COLOPHON

     This  page  is  part of release 4.16 of the Linux man-pages project.  A
     description of the project, information about reporting bugs,  and  the
     latest     version     of     this    page,    can    be    found    at
     https://www.kernel.org/doc/man-pages/.
                                2017-09-15                         FPURGE(3)
/data/webs/external/dokuwiki/data/pages/man/fpurge.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki