explain_ftime_or_die(3)

💖 explain_ftime_or_die — the manual, but make it make sense 💖

okay bestie, welcome to explain_ftime_or_die(3) from the Library Functions Manual. yes it's a mouthful, no we're not skipping any of it. sit down, grab a boba, let's go 🧋✨

---

🌸 NAME 🌸

explain_ftime_or_die — get the date and time, and if it goes wrong, we tell you about it (loudly)

---

🎀 SYNOPSIS 🎀

#include <libexplain/ftime.h>
void explain_ftime_or_die(struct timeb *tp);
int explain_ftime_on_error(struct timeb *tp);

look at those two little function signatures just vibing 💅

---

✨ DESCRIPTION ✨

so, the explain_ftime_or_die function is the one you call when you want to hit up the ftime(3) system call. if it fails? it prints an explanation to stderr — and that explanation is served fresh by the explain_ftime(3) function — and then the process terminates by calling exit(EXIT_FAILURE). yeah. it does not come back. it's giving main character exits the building 🚪💀

meanwhile, the explain_ftime_on_error function is the chill sibling: it also calls the ftime(3) system call, and on failure it also prints an explanation to stderr obtained from explain_ftime(3)... but then it just returns to you like nothing happened. no dramatic exit. 🫶

• tp — the tp, exactly as to be passed to the ftime(3) system call. no notes, no changes, verbatim.

---

🌈 RETURN VALUE 🌈

• The explain_ftime_or_die function only returns on success — for the full tea, go peek at ftime(3). On failure it prints an explanation and exits, which means... it does not return. at all. periodt.
• The explain_ftime_on_error function always returns the value returned by the wrapped ftime(3) system call. always. she's reliable like that ⭐

---

🦋 EXAMPLE 🦋

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

explain_ftime_or_die(tp);

that's it. that's the whole vibe. iconic honestly 👑

---

👑 SEE ALSO 👑

• ftime(3) — return date and time
• explain_ftime(3) — explain ftime(3) errors
• exit(2) — terminate the calling process

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

okay that's the whole page, you read the whole thing, I'm so proud of you 😭💖 this has been explain_ftime_or_die(3) from the Library Functions Manual — libexplain version 1.4, copyright 2009 Peter Miller — stay hydrated, call ftime(3) responsibly, and remember: if it fails, at least it explains itself. no cap. bye bestie 🎀✨🦋