ICONV_CANONICALIZE(3)

💖 ICONV_CANONICALIZE(3) 💖

okay so bestie, real talk: this is a page from the Library Functions Manual, and today's main character is iconv_canonicalize — a libc function that takes your messy encoding name and gives it a glow-up into its one true canonical form. ✨

---

🎀 LIBRARY 🎀

Standard C Library — that's libc, and you link it with -lc. classic, iconic, always invited to the party. 💅

---

🌸 SYNOPSIS 🌸

#include <iconv.h>

const char *
iconv_canonicalize(const char *name);

like, that's the whole vibe. one include, one function, one const char * coming back at you. 🫶

---

🦋 DESCRIPTION 🦋

So the iconv_canonicalize() function does one (1) thing and does it slay: it resolves the character encoding name you passed in as the name argument, and gives you back its canonical form. no cap. if you hand it some alias or alternate spelling of an encoding, it's gonna point you at the real one. that's the whole job. 🎀

---

⭐ RETURN VALUES ⭐

• success — upon successful completion, iconv_canonicalize() returns the canonical name of the given encoding. ✨
• already iconic — if the name you specified is already a canonical name, the same value is returned. (no notes. already perfect.) 👑
• not a real encoding — if the specified name is not an existing character encoding name, NULL is returned. 💀

---

🔥 SEE ALSO 🔥

• iconv(3) — the main character's bestie, go read it

---

🌈 STANDARDS 🌈

okay so iconv_canonicalize is not standard — it's a non-standard extension, which first appeared in the GNU implementation and then was adopted in FreeBSD 9.0, for compatibility's sake. so like, if you're on something that isn't glibc-or-FreeBSD-flavored, do a vibe check first. 🙈

---

💜 AUTHORS 💜

This manual page was written by Gabor Kovesdan <gabor@FreeBSD.org>. thank you gabor, you ate. 🍓

---

ngl this one's short and sweet — but the details are load-bearing, so don't go renaming your encodings and expecting a different answer. 🧚

---

and that's a wrap bestie!! 💖 this page came to you from Debian, dated October 20, 2009, and it's the ICONV_CANONICALIZE(3) page — go canon-ify something. periodt. 💅✨