idna\_to\_unicode\_8z8z(3) libidn idna\_to\_unicode\_8z8z(3)

# [NAME](#NAME)

idna\_to\_unicode\_8z8z - API function

# [SYNOPSIS](#SYNOPSIS)

**#include <idna.h>**

**int idna\_to\_unicode\_8z8z(const char * input, char \** output, int flags);**

# [ARGUMENTS](#ARGUMENTS)

[const char * input](#const)

zero-terminated UTF-8 string.

[char \** output](#char)

pointer to newly allocated output UTF-8 string.

[int flags](#int)

an **Idna\_flags** value, e.g., **IDNA\_ALLOW\_UNASSIGNED** or **IDNA\_USE\_STD3\_ASCII\_RULES**.

# [DESCRIPTION](#DESCRIPTION)

Convert possibly ACE encoded domain name in UTF-8 format into a UTF-8 string. The domain name may contain several labels, separated by dots. The output buffer must be deallocated by the caller.

Return value: Returns **IDNA\_SUCCESS** on success, or error code.

# [REPORTING BUGS](#REPORTING_BUGS)

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](#COPYRIGHT)

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.

# [SEE ALSO](#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/**

1.44 libidn

---

Document: idna_to_unicode_8z8z(3) from libidn 1.44-r6 (Chainguard OS)
Source: https://gitlab.com/libidn/libidn