idna_strerror(3)

idna_strerror3

Api function

Usage

#include <idna.h>

const char * idna_strerror(Idna_rc rc);

Arguments

Idna_rc rc

an Idna_rc return code.

Overview

Convert a return code integer to a text string. This string can be used to output a diagnostic message to the user.

Idna_success

Successful operation. This value is guaranteed to always be zero, the remaining ones are only guaranteed to hold non-zero values, for logical comparison purposes.

Idna_stringprep_error

Error during string preparation.

Idna_punycode_error

Error during punycode operation.

Idna_contains_non_ldh

For IDNA_USE_STD3_ASCII_RULES, indicate that the string contains non-LDH ASCII characters.

Idna_contains_minus

For IDNA_USE_STD3_ASCII_RULES, indicate 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.

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.

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 (this is typically a fatal error).

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 .

Releases

11 releases since Debian 3.1 (Sarge); the text changed 8 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 9–11
  7. 12
  8. 13
  9. Arch

Reporting bugs

Report bugs to <[email protected]>.
General guidelines for reporting bugs: https://www.gnu.org/gethelp/
GNU Libidn home page: https://www.gnu.org/software/libidn/

From libidn 1.44-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.