idna_to_ascii_4z(3)

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

✨ idna_to_ascii_4z(3) — the libidn glow-up ✨

okay bestie, gather round, because this one is a little function with big main character energy 💅 it lives in libidn, and its whole job is turning your fancy Unicode domain name into boring-but-necessary ASCII. it's literally called idna_to_ascii_4z. iconic. let's get into it 🫶

🌸 NAME 🌸

idna_to_ascii_4z — it's an API function, bestie. that's the whole vibe ✨

🎀 SYNOPSIS 🎀

#include <idna.h>

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

🦋 ARGUMENTS 🦋

  • const uint32_t * input — your input Unicode string, zero terminated. like, it has to end in a zero or she's not coming to the party 🚫
  • char ** output — a pointer to the newly allocated output string. note: newly allocated, so somebody's gotta clean up after her (spoiler: it's you, see below 😭)
  • int flags — an Idna_flags value, for example IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES. pick your fighter ✨

💖 DESCRIPTION 💖

Convert a UCS-4 domain name to an ASCII string. that's it, that's the gig 👑

the domain name can contain several labels, separated by dots. so like, multiple lil segments, all chillin' with . between them 🍓

🚨 IMPORTANT: the output buffer must be deallocated by the caller. she does not clean up after herself, bestie. that memory is your responsibility now. no cap.

Return value: returns IDNA_SUCCESS on success, or an error code. so always check the return value, fr fr 🙈

😭 REPORTING BUGS 😭

found a bug? spill the tea, but spill it to the right place:

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: share it, remix it, whatever — just keep the notice. slay 🌈)

🌈 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, 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/

that's the whole page, bestie 💜 this was libidn, version 1.44, and honestly? she ate. periodt. ✨🎀🦋

📦 where this page comes from