idna_to_unicode_8zlz(3)

📦
version 1.44 · 5 versions
, in arch rolling, epel 10, fedora 43, fedora 44, ubuntu stonking

💖 idna_to_unicode_8zlz(3) — bestie edition 💖

okay so this is a page from the libidn manual, section 3 (that's the "library functions" section, iykyk). the function's name is idna_to_unicode_8zlz, and the manual file itself is literally just labeled "API function" — no notes, no drama, just vibes. let's get into it 🦋

✨ SYNOPSIS ✨

#include <idna.h>

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

🎀 ARGUMENTS 🎀

  • const char * input — a zero-terminated UTF-8 string, bestie. that's it, that's the whole job.
  • char ** output — a pointer to a newly allocated output string, and that string is encoded in the current locale's character set. (yes, newly allocated, so somebody's gotta free it — see below 👀)
  • int flags — an Idna_flags value, like IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.

🌸 DESCRIPTION 🌸

so what does it actually do? it takes a domain name that's possibly ACE encoded and sitting there in UTF-8 format, and converts it into a string encoded in the current locale's character set. glow-up for your locale, honestly 💅

and no, the domain name isn't limited to one little label — it can contain several labels, separated by dots. so like, a whole domain situation, not just one chunk. slay.

⚠️ the output buffer must be deallocated by the caller. this is not a drill. you allocate it (well, the function does), and you free it. the function is not gonna clean up after you, that's not the dynamic here 😭

Return value: returns IDNA_SUCCESS on success, or an error code. iconic behavior.

🙈 REPORTING BUGS 🙈

found a bug? spill it to <help-libidn@gnu.org>.

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

and the GNU Libidn home page is right here: https://www.gnu.org/software/libidn/

Copyright © 2002-2026 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, go off, but keep the receipts 💖

🫶 SEE ALSO 🫶

the full documentation for libidn is maintained as a Texinfo manual (yes, Texinfo, she's old but she's that girl). if the info and libidn programs are properly installed at your site, this command:

info libidn

should give you access to the complete manual. as an alternative, you may obtain the manual from:

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

and that's the whole page, bestie ✨ this was idna_to_unicode_8zlz(3) from libidn, version 1.44, and the footer stamped it as idna_to_unicode_8zlz(3) — so yeah, go convert those domain names, free your buffers, and stay hydrated 🌈💜

📦 where this page comes from