explain_setvbuf_or_die(3)

💖 explain_setvbuf_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual page for explain_setvbuf_or_die — yes the whole name is a mouthful, we love her anyway 🎀

---

✨ NAME ✨

explain_setvbuf_or_die — stream buffering operations and report errors 🦋

---

✨ SYNOPSIS ✨

#include <libexplain/setvbuf.h>
void explain_setvbuf_or_die(FILE *fp, char *data, int mode, size_t
size);
int explain_setvbuf_on_error(FILE *fp, char *data, int mode, size_t
size);

---

✨ DESCRIPTION ✨

so, the tea ☕ — explain_setvbuf_or_die is the function you call when you wanna call the setvbuf(3) system call. if it fails, an explanation gets printed to stderr (courtesy of the explain_setvbuf(3) function), and then the process terminates by calling exit(EXIT_FAILURE). like. she's not playing around. 💀

and then there's explain_setvbuf_on_error — same energy, she also calls the setvbuf(3) system call, and on failure an explanation also gets printed to stderr from explain_setvbuf(3)... but she still returns to the caller. no dramatic exit, just vibes. 🫶

the arguments, bestie 🌸

• fp — the fp, exactly as to be passed to the setvbuf(3) system call.
• data — the data, exactly as to be passed to the setvbuf(3) system call.
• mode — the mode, exactly as to be passed to the setvbuf(3) system call.
• size — the size, exactly as to be passed to the setvbuf(3) system call.

fr fr, they're passed through exactly. don't get creative with them. 💅

---

✨ RETURN VALUE ✨

explain_setvbuf_or_die only returns on success — peep setvbuf(3) for more info. on failure she prints an explanation and exits, she does not return. main character exit, no goodbye 😭

explain_setvbuf_on_error always returns the value returned by the wrapped setvbuf(3) system call. every single time. no cap. 👑

---

✨ EXAMPLE ✨

the explain_setvbuf_or_die function is intended to be used in a fashion similar to the following example, iykyk:

explain_setvbuf_or_die(fp, data, mode, size);

---

✨ SEE ALSO ✨

• setvbuf(3) — stream buffering operations
• explain_setvbuf(3) — explain setvbuf(3) errors
• exit(2) — terminate the calling process

---

✨ COPYRIGHT ✨

libexplain version 1.4 Copyright (C) 2010 Peter Miller

---

okay that's the whole page, you ate that 🍓✨ libexplain version 1.4, copyright (C) 2010 Peter Miller, and the date/footer situation is literally just explain_setvbuf_or_die(3) — so that's your cute little sign-off, bestie, go forth and buffer those streams responsibly 💜🧚