explain_fputs_or_die(3)

✨ explain_fputs_or_die ✨

okay bestie, welcome to explain_fputs_or_die(3) 💖 this one lives in the Library Functions Manual, and she's literally here to make sure your string-writing never goes down in silence. no cap.

---

🌸 NAME 🌸

explain_fputs_or_die — write a string to a stream and report errors 🦋

---

🎀 SYNOPSIS 🎀

#include <libexplain/fputs.h>
void explain_fputs_or_die(const char *s, FILE *fp);
int explain_fputs_on_error(const char *s, FILE *fp);

---

💅 DESCRIPTION 💅

so here's the tea, bestie 🍓 the explain_fputs_or_die function is used to call the fputs(3) system call. and if that goes wrong? it prints an explanation to stderr — obtained from the explain_fputs(3) function — and then the process terminates by calling exit(EXIT_FAILURE). like, full main character exit. no coming back. 💀

the explain_fputs_on_error function is also used to call the fputs(3) system call. and yeah, on failure it also prints an explanation to stderr, obtained from the explain_fputs(3) function — but she's the chill one, she still returns to the caller. 🫶

• s — the s, exactly as to be passed to the fputs(3) system call. exactly exactly. don't get creative with it ✨
• fp — the fp, exactly as to be passed to the fputs(3) system call. same energy, verbatim 💜

---

👑 RETURN VALUE 👑

the explain_fputs_or_die function only returns on success — check out fputs(3) for more info on that. on failure? it prints an explanation and exits. it does not return. periodt. 💅

the explain_fputs_on_error function always returns the value return by the wrapped fputs(3) system call. so you always get your lil answer back. 😌

---

🌈 EXAMPLE 🌈

the explain_fputs_or_die function is intended to be used in a fashion similar to the following example:

explain_fputs_or_die(s, fp);

look at her go 🧚 iconic honestly.

---

🔥 SEE ALSO 🔥

• fputs(3) — write a string to a stream
• explain_fputs(3) — explain fputs(3) errors
• exit(2) — terminate the calling process

---

💖 COPYRIGHT 💖

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

and that's the whole page, bestie 🎀 go forth and write your strings, and if it fails at least you'll get an explanation before the lights go out ✨ explain_fputs_or_die(3), Library Functions Manual, libexplain version 1.4, Copyright (C) 2009 Peter Miller — mwah 💋 slay 💜