ICONVLIST(3)

✨ ICONVLIST(3) ✨

ok so bestie, we're in the Standard C Library (libc, -lc) today and the function we're stanning is iconvlist — the iconv(3) girlies are gonna eat this one UP 💅 no cap

---

🌸 NAME 🌸

iconvlist — getting urself a whole list of character encodings that iconv(3) supports 🫶 literally the cheat sheet of every encoding your system fw

---

🎀 LIBRARY 🎀

Standard C Library (libc, -lc)

---

✨ SYNOPSIS ✨

#include <iconv.h>

void
iconvlist(int (*do_one)(unsigned int *count, const char * const *names, void *arg),
    void *arg);

ok the signature is lowkey a mouthful but we'll get through it together, promise 🧚

---

🦋 DESCRIPTION 🦋

so iconvlist() gets u a list of all the character encodings that the iconv(3) call supports. like, every single one your system knows about. iconic behavior honestly 👑

and here's how it hands them to u: your do_one() callback function gets called, and the args go like this:

• count — gets set to the number of encoding names found (the headcount, iykyk)
• names — the actual list of supported encoding names
• arg — this is literally just the arg argument u passed to iconvlist() in the first place. it's your little baton to pass custom data back and forth between whoever called iconvlist() and the callback function. main character energy for real 🔥

🫶 heads up bestie: if an error happens, names will be NULL when do_one() gets called. so pls do a vibe check on that pointer, don't just assume it's valid 😭

---

💖 SEE ALSO 💖

• __iconv_free_list(3)
• __iconv_get_list(3)
• iconv(3)

---

⭐ STANDARDS ⭐

ok so real talk: the iconvlist function is a non-standard extension, ngl. it first showed up in the GNU implementation, and then FreeBSD 9.0 adopted it for compatibility's sake. so it's not in any standard, she just travels 🌈

---

🌸 AUTHORS 🌸

this manual page was written by Gabor Kovesdan <gabor@FreeBSD.org> — ty bestie for the docs 🫶

---

and that's the whole page diva 💅✨

Debian, October 20, 2009 — yeah she's an oldie but a goodie 🎀 mwah 💋