.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "idn2_to_unicode_8zlz" 3 "2.3.1.48-1925" "libidn2" "libidn2"
.SH NAME
idn2_to_unicode_8zlz \- API function
.SH SYNOPSIS
.B #include <idn2.h>
.sp
.BI "int idn2_to_unicode_8zlz(const char * " input ", char ** " output ", int " flags ");"
.SH ARGUMENTS
.IP "const char * input" 12
Input zero\-terminated UTF\-8 string.
.IP "char ** output" 12
Newly allocated output string in current locale's character set.
.IP "int flags" 12
Currently unused.
.SH "DESCRIPTION"
Converts a possibly ACE encoded domain name in UTF\-8 format into a
string encoded in the current locale's character set (punycode
decoding). The output buffer will be zero\-terminated and must be
deallocated by the caller.

 \fIoutput\fP may be NULL to test lookup of  \fIinput\fP without allocating memory.
.SH "SINCE"
2.0.0
.SH "SEE ALSO"
The full documentation for
.B libidn2
is maintained as a Texinfo manual.  If the
.B info
and
.B libidn2
programs are properly installed at your site, the command
.IP
.B info libidn2
.PP
should give you access to the complete manual.
As an alternative you may obtain the manual from:
.IP
.B https://www.gnu.org/software/libidn/libidn2/manual/
.PP