fpurge(3bsd)

✨ fpurge — flush a stream ✨

okay bestie, welcome to the fpurge page 💅 this is from the 3bsd manual section, local vibes only, and it's literally the stream-clearing baddie you didn't know you needed.

🎀 LIBRARY

utility functions from BSD systems, aka libbsd, and you link it with -lbsd. yes that's the whole thing. she's low maintenance fr fr 🫶

🌸 SYNOPSIS

#include <stdio.h>
(See libbsd(7) for include usage.)

int
fpurge(FILE *stream);

side note bestie: peep libbsd(7) for the whole include-usage situation, it's giving "read the fine print" 🙈

🦋 DESCRIPTION

so the function fpurge() erases any input or output buffered in the given stream. no cap, all of it, gone.

for output streams, this discards any unwritten output. bye bestie, never made it out the door 💀

for input streams, this discards any input that was read from the underlying object but hasn't yet been obtained via getc(3). and yes, that includes any text that got pushed back via ungetc(3). she's thorough. she's iconic. periodt. 👑

💖 RETURN VALUES

• upon successful completion, 0 is returned ✨
• otherwise, EOF is returned, and the global variable errno is set to indicate the error 😭

🔥 ERRORS

• [EBADF] — stream is not an open stream. like girl. she's not even open. what are we doing here 🙈

🌈 SEE ALSO

• fclose(3)
• fopen(3)
• setvbuf(3)

👑 HISTORY

the fpurge() function first appeared in 4.4BSD-Lite. a legend from the jump, we love a historical queen 💜

and that's the whole page bestie, no notes 🎀 this version is from the Debian crew and it's dated November 4, 2015 — mwah, go clear some buffers, you got this 🦋✨💅