EXPLAIN_VASPRINTF_OR_DIE(3)

💖 explain_vasprintf_or_die(3) 💖

okay bestie, so this one lives in the Library Functions Manual and it's literally called explain_vasprintf_or_die — yes the name is dramatic, no we are not changing it 🫶

---

✨ NAME ✨

explain_vasprintf_or_die — print to allocated string and report errors 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/vasprintf.h>
int explain_vasprintf_or_die(char **data, const char *format, va_list
ap);
int explain_vasprintf_on_error(char **data, const char *format, va_list
ap);

---

🦋 DESCRIPTION 🦋

so there's two of them and they're siblings, not twins, okay? let's get into it 🎀

The explain_vasprintf_or_die function is used to call the vasprintf(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_vasprintf(3) function, and then the process terminates by calling exit(EXIT_FAILURE). so like. it dies. on brand, honestly 💀

The explain_vasprintf_on_error function is used to call the vasprintf(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_vasprintf(3) function, but still returns to the caller. it's giving "I'll tell you what went wrong but I'm not gonna end you over it" ✨

• data — the data, exactly as to be passed to the vasprintf(3) system call. yes, exactly. don't get cute with it 🙈
• format — the format, exactly as to be passed to the vasprintf(3) system call. same energy, same rule 💖
• ap — the ap, exactly as to be passed to the vasprintf(3) system call. all three of them? passed through untouched. iconic behavior, no notes 👑

---

🌈 RETURN VALUE 🌈

The explain_vasprintf_or_die function only returns on success, see vasprintf(3) for more information. On failure, prints an explanation and exits, it does not return. like. it's not coming back. periodt 💅

The explain_vasprintf_on_error function always returns the value return by the wrapped vasprintf(3) system call. always. every time. no cap 🫶

---

🍓 EXAMPLE 🍓

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

int result = explain_vasprintf_or_die(data, format, ap);

that's it. that's the whole vibe. copy it, love it, ship it 🎀

---

💜 SEE ALSO 💜

• vasprintf(3) — print to allocated string
• explain_vasprintf(3) — explain vasprintf(3) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page bestie!! 🦋✨ this was libexplain version 1.4, copyright vibes belonging to Peter Miller in 2013, and we are obsessed. go forth and vasprintf responsibly, mwah 💖💅🌸