explain_putw_or_die(3)

💖 explain_putw_or_die — output a word (int) and report errors 💖

okay bestie, gather round, because this is the explain_putw_or_die(3) page from the Library Functions Manual and it's literally about writing a word to a file and not letting errors go unaddressed. no cap. 🎀

---

✨ SYNOPSIS ✨

#include <libexplain/putw.h>
void explain_putw_or_die(int value, FILE *fp);
int explain_putw_on_error(int value, FILE *fp);

like, that's the whole vibe right there. two functions. two destinies. 💅

---

🌸 DESCRIPTION 🌸

so, the explain_putw_or_die function is used to call the putw(3) system call. and when it fails? bestie, an explanation gets printed to stderr, and it's obtained from the explain_putw(3) function, and then the process terminates by calling exit(EXIT_FAILURE). it's giving dramatic exit. main character energy fr fr. 💀

meanwhile, the explain_putw_on_error function is also used to call the putw(3) system call. on failure, an explanation gets printed to stderr too — also obtained from the explain_putw(3) function — but this one still returns to the caller. it's the chill sibling. it stays. 🫶

• value — the value, exactly as to be passed to the putw(3) system call. exactly. don't get creative with it. 🍓
• fp — the fp, exactly as to be passed to the putw(3) system call. same energy. exactly as-is. ✨

---

👑 RETURN VALUE 👑

the explain_putw_or_die function only returns on success — see putw(3) for more information. on failure, it prints an explanation and exits, so it does not return. like, it's gone. it left the chat. 😭

the explain_putw_on_error function always returns the value return by the wrapped putw(3) system call. (yes, "return by", that's what it says, we're keeping it, no editing the sacred texts 💜)

---

🌈 EXAMPLE 🌈

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

explain_putw_or_die(value, fp);

that's it. that's the moment. iconic. ⭐

---

🔥 SEE ALSO 🔥

• putw(3) — output a word (int)
• explain_putw(3) — explain putw(3) errors
• exit(2) — terminate the calling process

iykyk, this is the whole family tree right here. 🦋

---

💖 COPYRIGHT 💖

this is from libexplain version 1.4, and the copyright belongs to Copyright (C) 2010 Peter Miller. respect the author, bestie, they built this whole thing. 🙈

---

okay that's the page!! sending you off with the biggest sparkle, no notes, go write your words safely and let explain_putw_or_die handle the drama for you. periodt. 💅✨🌸🎀🫶💜