idn2_to_unicode_4z4z(3)

📦
version 2.3.8 · 5 versions
, in alpine 3.23, alpine 3.24, arch rolling, debian trixie, fedora 43, fedora 44, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 idn2_to_unicode_4z4z — the libidn2 glow-up page 💖

okay bestie, welcome to the manual page for idn2_to_unicode_4z4z(3) from libidn2 — yes it's an API function, and yes it's lowkey iconic. pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

idn2_to_unicode_4z4z — API function 💅

🌸 SYNOPSIS 🌸

#include <idn2.h>

int idn2_to_unicode_4z4z(const uint32_t * input, uint32_t ** output, int
flags);

literally that's the whole vibe. include the header, call the function, slay. ✨

🎀 ARGUMENTS 🎀

  • const uint32_t * input — the input, bestie. it's a zero-terminated UTF-32 string. 🦋
  • uint32_t ** output — the newly allocated UTF-32 output string. fresh out of the allocator, main character energy. 👑
  • int flags — currently unused. it's giving placeholder, it's giving "we'll get to it later". 🙈

💜 DESCRIPTION 💜

so what does it actually do? it converts a possibly ACE encoded domain name in UTF-32 format into a UTF-32 string — aka punycode decoding. the way that punycode just gets un-punycoded… obsessed. 🔥

the output buffer will be zero-terminated and must be deallocated by the caller. no cap, that's on you, not on the library. free your memory, bestie. 🫶

also: output may be NULL to test lookup of input without allocating memory. so if you're just vibing and checking whether something resolves, you don't have to commit to a whole buffer. very demure, very mindful. 🧚

⭐ SINCE ⭐

2.0.0 — it's been around, it's a classic, it ate and left no crumbs. 💖

😭 REPORTING BUGS 😭

found something cursed? report bugs to <help-libidn@gnu.org>. 💀

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

and the libidn2 home page is right here: https://www.gnu.org/software/libidn2/

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. fr fr, go forth and redistribute. ✨

🦋 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. iykyk. 📖

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 libidn2 version 2.3.8, and you just read idn2_to_unicode_4z4z(3) — go decode something gorgeous. bye bestie, mwah 💅💖🦋

📦 where this page comes from