idna_to_ascii_lz(3)

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

💖 idna_to_ascii_lz(3) — the libidn glow-up 💖

okay bestie, sit down, hydrate, because we're about to talk about the manual page for idna_to_ascii_lz, straight out of libidn (we're on version 1.44 here, no cap). it's an API function, it's iconic, and honestly? it ate.

✨ NAME ✨

idna_to_ascii_lz — API function. that's it, that's the name, she's simple, she's elegant, she converts stuff. 🎀

🌸 SYNOPSIS 🌸

#include <idna.h>

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

like... look at her. three params. no drama. 🦋

🫶 ARGUMENTS 🫶

  • const char * input — the zero terminated input string, encoded in the current locale's character set. so like, whatever your locale is vibing with at that moment, that's the encoding bestie. zero terminated, so don't forget your \0, that's her whole personality.
  • char ** output — a pointer to the newly allocated output string. she's freshly allocated, she's new, she's got main character energy, and she is yours to free (more on that in a sec, don't panic).
  • int flags — an Idna_flags value. for example IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES. pick your fighter, or don't, whatever, it's your call. 💅

🌈 DESCRIPTION 🌈

so here's the tea: this function converts a domain name that's in the locale's encoding into an ASCII string. glow-up complete, periodt. ✨

and the domain name? it may contain several labels, separated by dots. so like, the whole thing, not just one little piece — she handles the full slay.

🚨 okay this is the important part, bestie: the output buffer must be deallocated by the caller. that's you. you're the caller. it's your responsibility. no one else is coming to free that memory for you, and if you don't, that's a leak and we do NOT want a leak, we want a clean free(). 🔥

Return value: returns IDNA_SUCCESS on success, or an error code. so check her. don't just assume she worked, that's not the vibe. 🫶

😭 REPORTING BUGS 😭

found a bug? not me manifesting it, but if it happens:

go tell them, they want to know, they're literally asking. 💜

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. (translation: go off, remix it, just keep the receipts. that's the rule, and honestly? fair. 🎀)

🦋 SEE ALSO 🦋

The full documentation for libidn is maintained as a Texinfo manual. If the info and libidn programs are properly installed at your site, the 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/

iykyk, the Texinfo manual is where the deep lore lives. go read her. 📖✨

and that's the whole page, bestie!! 🎀 this was idna_to_ascii_lz(3) from libidn, version 1.44, and it was a whole moment. now go free() your output buffer before you forget, I'm literally watching you. mwah 💖🌸🦋💅

📦 where this page comes from