idn2_to_unicode_lzlz(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_lzlz — bestie edition 💖

okay so this is a page from the libidn2 manual, and honestly? she's giving "quietly essential". sit down, grab a boba, we're decoding punycode together 🧋✨

🌸 NAME 🌸

idn2_to_unicode_lzlz — it's an API function, babes. that's the whole name. no notes. 💅

✨ SYNOPSIS ✨

#include <idn2.h>

int idn2_to_unicode_lzlz(const char * input, char ** output, int flags);

like, yes, that's the whole vibe. short king of a function signature 👑

🎀 ARGUMENTS 🎀

  • const char * input — the string you're feeding in. it's zero-terminated and encoded in your current locale's character set. so like, whatever charset your locale is rolling with, that's what she speaks. no switching up mid-conversation, okay? 🙈
  • char ** output — where the glow-up lands. this is a newly allocated output string, also in the current locale's character set. she's fresh out the box, she's yours to free. 🦋
  • int flags — currently unused. literally just sitting there. main character energy of doing absolutely nothing but still being in the cast list 💀

💜 DESCRIPTION 💜

so what does she actually DO? she takes a domain name that might be ACE encoded (think xn-- nonsense) sitting in your locale's character set, and converts it into a string encoded in the current locale's character set. that's the punycode decoding moment, bestie. the transformation. the reveal. ✨

two things you need to remember, fr fr:

  • the output buffer is zero-terminated, and the caller has to deallocate it. yes YOU. you're the caller. it's your responsibility. don't ghost your malloc'd memory, that's toxic 😭
  • output can be NULL — and that's not a bug, that's a feature! it lets you test the lookup of input without allocating any memory. a little vibe check before you commit. iconic, honestly 🫶

⭐ SINCE ⭐

2.0.0 — she's been here a minute. veteran behavior 👑

🐛 REPORTING BUGS 🐛

found something cursed? don't suffer in silence, tell the devs:

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.

(so like, copy it, remix it, put it on your story, just keep the credit. periodt 💅)

🔥 SEE ALSO 🔥

the full documentation for libidn2 lives in a Texinfo manual. if the info and libidn2 programs are properly installed at your site, this command:

info libidn2

should give you access to the complete manual. 🧚

and if you can't be bothered with that, you can also grab the manual from:

https://www.gnu.org/software/libidn/libidn2/manual/
lowkey reminder: flags is unused, output may be NULL, and whatever she hands back is yours to free. no cap. 🫶

and that's the whole page, bestie! this was libidn2, version 2.3.8, serving idn2_to_unicode_lzlz(3) realness. go decode something gorgeous, ily, bye 💖✨🎀

📦 where this page comes from