Next: fputc, Previous: fopencookie, Up: Stdio [Contents][Index]

### 4.19 `fpurge`—discard pending file I/O

Synopsis

    #include <stdio.h>
    int fpurge(FILE *fp);

    int _fpurge_r(struct _reent *reent, FILE *fp);

    #include <stdio.h>
    #include <stdio_ext.h>
    void  __fpurge(FILE *fp);

Description
Use `fpurge` to clear all buffers of the given stream. For output streams, this discards data not yet written to disk. For input streams, this discards any data from `ungetc` and any data retrieved from disk but not yet read via `getc`. This is more severe than `fflush`, and generally is only needed when manually altering the underlying file descriptor of a stream.

`__fpurge` behaves exactly like `fpurge` but does not return a value.

The alternate function `_fpurge_r` is a reentrant version, where the extra argument reent is a pointer to a reentrancy structure, and fp must not be NULL.

Returns
`fpurge` returns `0` unless fp is not valid, in which case it returns `EOF` and sets `errno`.

Portability
These functions are not portable to any standard.

No supporting OS subroutines are required.