EXPLAIN_ICONV_OPEN_OR_DIE(3)

💖 explain_iconv_open_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual ✨ this one's short and sweet, we love a low-effort icon 💅

---

🎀 NAME 🎀

explain_iconv_open_or_die — get yourself ready for charset conversion, and if it goes sideways? report the errors like a queen 🫶

---

🌸 SYNOPSIS 🌸

#include <libexplain/iconv_open.h>
iconv_t explain_iconv_open_or_die(const char *tocode, const char *fromcode);
iconv_t explain_iconv_open_on_error(const char *tocode, const char *fromcode);

---

✨ DESCRIPTION ✨

so explain_iconv_open_or_die is literally just a wrapper that calls the iconv_open(3) system call. but the way it does it?? 💅 if it fails, it prints an explanation to stderr — that explanation comes from the explain_iconv_open(3) function — and then it terminates the process by calling exit(EXIT_FAILURE). dramatic? yes. effective? also yes. no cap. 💀

and then explain_iconv_open_on_error also calls iconv_open(3), and on failure it also prints an explanation to stderr from explain_iconv_open(3)... but it still returns to the caller 🫶 like, it tells you what went wrong and then hands the vibes back to you. main character energy fr fr.

Now the arguments, bestie:

• tocode — the tocode, exactly as it's meant to be passed to the iconv_open(3) system call. don't get creative with it, okay? 🙈
• fromcode — the fromcode, exactly as it's meant to be passed to the iconv_open(3) system call. same energy, same rule. ⭐

---

💜 RETURN VALUE 💜

explain_iconv_open_or_die only returns on success — peep iconv_open(3) if you want the full tea on that. on failure it prints an explanation and exits. like, it does not return. periodt. 😭

explain_iconv_open_on_error always returns the value that the wrapped iconv_open(3) system call gave back. always. every time. slay. ✨

---

🌈 EXAMPLE 🌈

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

iconv_t result = explain_iconv_open_or_die(tocode, fromcode);

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

---

🦋 SEE ALSO 🦋

• iconv_open(3) — allocate descriptor for character set conversion
• explain_iconv_open(3) — explain iconv_open(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!! 🎀 go forth and convert charsets responsibly, mwah 💖✨

— explain_ic...open_or_die(3) , signing off 🌸🫶⭐