gnutls_idna_reverse_map(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_idna_reverse_map ✨

okay bestie, welcome to the gnutls manual, section 3 — yes we're in the big girl section, the library functions 💅 this one's called gnutls_idna_reverse_map and it's giving "turn the ugly punycode back into pretty Unicode" energy 🦋

🌸 NAME 🌸

gnutls_idna_reverse_map — an API function, babes. that's the whole vibe. 🎀

🌈 SYNOPSIS 🌈

#include <gnutls/gnutls.h>

int gnutls_idna_reverse_map(const char * input, unsigned ilen,
       gnutls_datum_t * out, unsigned flags);

💖 ARGUMENTS 💖

  • const char * input — the domain name in ACE (IDNA) format, so like the ASCII-encoded version. you know, the xn-- looking situation 🙈
  • unsigned ilen — the length of the string you just handed over. yes you gotta tell it how long it is, no it won't guess ✨
  • gnutls_datum_t * out — where the glow-up lands: the result as a null-terminated, allocated UTF-8 string 🫶
  • unsigned flags — should be zero. that's it. zero. don't get creative bestie 💀

👑 DESCRIPTION 👑

so what does this lil icon actually do? it converts an ACE (that's ASCII-encoded) domain name into a UTF-8 domain name. so you go from the crunchy xn-- form back to the pretty human-readable one. reverse glow-up, we love to see it 🌈✨

⚠️ real talk though: if GnuTLS was compiled without IDNA support, this function will just return GNUTLS_E_UNIMPLEMENTED_FEATURE. like, it's not mad, it's just not built for that 💀

also worth clocking: if you hand it an empty string, it will return an empty string. in and out, no notes, we respect the consistency 🎀

🦋 RETURNS 🦋

a negative error code if things went sideways, or 0 on success. simple. iconic. periodt 💅

⭐ SINCE ⭐

3.5.8 — been here since way back, a true veteran queen 👑

😭 REPORTING BUGS 😭

found something cursed? tell the devs, they wanna know fr fr:

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

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. slay, free as in freedom 💜

🌟 SEE ALSO 🌟

the full documentation for gnutls is maintained as a Texinfo manual, bestie. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, go visit:

https://www.gnutls.org/manual/

that's the plug, iykyk 🔥

and that's the whole page, babe 💖 this was the gnutls manual, version 3.8.13, gnutls_idna_reverse_map(3) — go forth and un-punycode your domains, you main character 🦋👑✨

📦 where this page comes from