idna_strerror(3)

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

✨ idna_strerror — bestie edition ✨

okay so real talk, this is page idna_strerror(3) from the libidn manual, and honestly? it's a glow-up for your error messages 💖

🌸 NAME 🌸

idna_strerror — turns a code into words, no cap

🎀 SYNOPSIS 🎀

#include <idna.h>

const char * idna_strerror(Idna_rc rc);

💅 ARGUMENTS 💅

  • Idna_rc rc — bestie, this is an Idna_rc return code. that's it. that's the whole vibe check.

🦋 DESCRIPTION 🦋

So here's the tea: this function takes a return code integer and converts it into a text string. And like, what's the string for? It's so you can output a diagnostic message to the user 💬. That's literally the whole job. Iconic, lowkey.

the return codes, one by one 👑

  • IDNA_SUCCESS — Successful operation ✨. And listen, this value is guaranteed to always be zero — like, always. The remaining ones are only guaranteed to hold non-zero values, and that's purely for logical comparison purposes. so don't come for the others expecting specific numbers, that's not the arrangement 🫶
  • IDNA_STRINGPREP_ERROR — Error during string preparation 😭
  • IDNA_PUNYCODE_ERROR — Error during punycode operation 💀
  • IDNA_CONTAINS_NON_LDH — For IDNA_USE_STD3_ASCII_RULES, this indicates that the string contains non-LDH ASCII characters 🙈
  • IDNA_CONTAINS_MINUS — For IDNA_USE_STD3_ASCII_RULES, this indicates that the string contains a leading or trailing hyphen-minus (U+002D) 🍓
  • IDNA_INVALID_LENGTH — The final output string is not within the (inclusive) range 1 to 63 characters. so like, 0? out. 64? also out. 1 through 63, inclusive, that's the range 🌈
  • IDNA_NO_ACE_PREFIX — The string does not contain the ACE prefix (for ToUnicode) 🧚
  • IDNA_ROUNDTRIP_VERIFY_ERROR — The ToASCII operation on output string does not equal the input. roundtrip said nope 💔
  • IDNA_CONTAINS_ACE_PREFIX — The input contains the ACE prefix (for ToASCII) 👑
  • IDNA_ICONV_ERROR — Character encoding conversion error 😬
  • IDNA_MALLOC_ERROR — Could not allocate buffer. and heads up bestie, this is typically a fatal error 🚨 like, for real, not a drill
  • IDNA_DLOPEN_ERROR — Could not dlopen the libcidn DSO (only used internally in libc) 💫

Return value: Returns a pointer to a statically allocated string containing a description of the error with the return code rc. note: statically allocated, so don't go freeing it or mutating it, that's not its journey 🫶

😭 REPORTING BUGS 😭

Found a bug? Tell the people! Report bugs to <help-libidn@gnu.org> 📧

General guidelines for reporting bugs: https://www.gnu.org/gethelp/

GNU Libidn home page: 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. periodt 💜

🌟 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/

and that's the whole page, bestie!! this lil slice of libidn version 1.44 was brought to you with so much love, mwah 💋 go forth and print your diagnostics, you absolute main character 🦋💖

📦 where this page comes from