---
name: "idna_to_unicode_4z4z"
section: "3"
platform: "linux"
package: "libidn"
version: "1.44-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/idna_to_unicode_4z4z"
---

# idna\_to\_unicode\_4z4z(3)

API function

## NAME

idna\_to\_unicode\_4z4z - API function

## SYNOPSIS

**#include \<idna.h\>**

**int idna\_to\_unicode\_4z4z(const uint32\_t \*** *input***, uint32\_t \*\*** *output***, int** *flags***);**

## ARGUMENTS

- const uint32\_t \* input

  zero-terminated Unicode string.

- uint32\_t \*\* output

  pointer to newly allocated output Unicode string.

- int flags

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

## DESCRIPTION

Convert possibly ACE encoded domain name in UCS-4 format into a UCS-4 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

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 © 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

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