explain_strdup_or_die(3)

✨ explain_strdup_or_die(3) ✨

okay bestie, welcome to the Library Functions Manual 💖 this is the page for explain_strdup_or_die, and yes the name is a whole mouthful but we're gonna get through it together, fr fr 🫶

---

🌸 NAME 🌸

explain_strdup_or_die — duplicate a string and report errors 💅

---

🎀 SYNOPSIS 🎀

#include <libexplain/strdup.h>
char *explain_strdup_or_die(const char *data);
char *explain_strdup_on_error(const char *data);

---

🦋 DESCRIPTION 🦋

So here's the tea ☕ — there are two little functions on this page and they're like sisters, same energy, different endings.

The explain_strdup_or_die function is used to call the strdup(3) system call. When it goes wrong? An explanation gets printed to stderr, and that explanation is obtained from the explain_strdup(3) function. Then — and this is the dramatic part 😭 — the process terminates by calling exit(EXIT_FAILURE). Like, it does not come back. It's giving final boss energy. 💀

The explain_strdup_on_error function is also used to call the strdup(3) system call, and on failure it also prints an explanation to stderr obtained from the explain_strdup(3) function — but this one is chill 🧘 it still returns to the caller. No dying today bestie ✨

the parameter 🍓

• data — the data, exactly as to be passed to the strdup(3) system call. literally exactly, don't get cute with it 💜

---

👑 RETURN VALUE 👑

The explain_strdup_or_die function only returns on success — see strdup(3) for more information. On failure it prints an explanation and exits, so like… it does not return. it's gone. bye 👋

The explain_strdup_on_error function always returns the value returned by the wrapped strdup(3) system call. every single time, no cap 🫶

---

🌈 EXAMPLE 🌈

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

char *result = explain_strdup_or_die(data);

look at her go 😌 iconic honestly

---

⭐ SEE ALSO ⭐

• strdup(3) — duplicate a string
• explain_strdup(3) — explain strdup(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, we ate and left no crumbs 💅🌸 this was explain_strdup_or_die(3) from the Library Functions Manual — libexplain version 1.4, copyright (C) 2009 Peter Miller. mwah, go forth and duplicate those strings responsibly 🎀✨🦋