idn2_to_unicode_8z4z(3)

✨ idn2_to_unicode_8z4z ✨

okay bestie, sit down, hydrate, because we're talking about a function from libidn2 — the man page section 3 kind, iykyk 💅. This one is literally called idn2_to_unicode_8z4z and it is here to take your cute little domain name and glow it up from UTF-8 into UTF-32. main character energy fr fr 🦋

---

🌸 NAME 🌸

idn2_to_unicode_8z4z — it's an API function, bestie. that's the whole vibe check.

---

📜 SYNOPSIS 📜

#include <idn2.h>

int idn2_to_unicode_8z4z(const char * input, uint32_t ** output,
G_GNUC_UNUSED int flags);

---

🎀 ARGUMENTS 🎀

• const char * input — your input string, bestie. It's zero-terminated UTF-8, so don't come in here with some half-baked unterminated nonsense 🙈.
• uint32_t ** output — the newly allocated UTF-32/UCS-4 output string. It's brand new, it's fresh, it's yours to free. ✨
• G_GNUC_UNUSED int flags — currently unused. it's giving decorative. it's giving placeholder. it's just sitting there being iconic and doing absolutely nothing 💀.

---

💖 DESCRIPTION 💖

So here's the tea ☕: this function converts a possibly ACE encoded domain name that's sitting in UTF-8 format into a UTF-32 string. That's the punycode decoding step, bestie — the glow-up from the compressed ACE form into the full gorgeous UTF-32 form 👑

The output buffer is zero-terminated, and — listen closely because this part matters — it must be deallocated by the caller. That's you. You're the caller. You're the main character, and the main character frees their own buffers. no cap 🫶

also, plot twist: output may be NULL, and that's valid! Pass NULL if you just wanna test the lookup of input without allocating any memory. a little sneak peek, a little vibe check, zero commitment 💅

---

⭐ SINCE ⭐

2.0.0 — she's been here since 2.0.0, a true veteran, an OG 👑

---

😭 REPORTING BUGS 😭

Found a bug? Not me finding a bug in libidn2 💀 — but if you do, report it to <help-libidn@gnu.org>.

General guidelines for reporting bugs live over at https://www.gnu.org/gethelp/

And the Libidn2 home page is right here: https://www.gnu.org/software/libidn2/ 🌈

---

🎀 COPYRIGHT 🎀

Copyright © 2002-2025 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. slay, that's a very chill license 🫶

---

👀 SEE ALSO 👀

The full documentation for libidn2 is maintained as a Texinfo manual. If the info and libidn2 programs are properly installed at your site, the command

info libidn2

should give you access to the complete manual. Obsessed with that for you 📖✨

As an alternative, you may obtain the manual from:

https://www.gnu.org/software/libidn/libidn2/manual/

---

and that's the whole page, bestie! 💜 this was idn2_to_unicode_8z4z(3) from libidn2 version 2.3.8 — go forth, decode your punycode, free your buffers, and be the UTF-32 icon you were always meant to be. bye bye 🦋🌸💅