Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
idn2_to_ascii_8z(3)		    libidn2		   idn2_to_ascii_8z(3)

NAME
       idn2_to_ascii_8z	- API function

SYNOPSIS
       #include	<idn2.h>

       int idn2_to_ascii_8z(const char * input,	char **	output,	int flags);

ARGUMENTS
       const char * input
		   zero	terminated input UTF-8 string.

       char ** output
		   pointer to newly allocated output string.

       int flags   optional idn2_flags to modify behaviour.

DESCRIPTION
       Convert	UTF-8  domain  name  to	ASCII string using the IDNA2008	rules.
       The domain name may contain several labels,  separated  by  dots.   The
       output buffer must be deallocated by the	caller.

       The default behavior of this function (when flags are zero) is to apply
       the IDNA2008 rules without the TR46 amendments. As the TR46 non-transi-
       tional  processing  is  nowadays	 ubiquitous, when unsure, it is	recom-
       mended to call this function  with  the	IDN2_NONTRANSITIONAL  and  the
       IDN2_NFC_INPUT flags for	compatibility with other software.

       Return value: Returns IDN2_OK on	success, or error code.

SINCE
       2.0.0

REPORTING BUGS
       Report bugs to <help-libidn@gnu.org>.
       General guidelines for reporting	bugs: https://www.gnu.org/gethelp/
       Libidn2 home page: https://www.gnu.org/software/libidn2/

COPYRIGHT
       Copyright (C) 2002-2025 Simon Josefsson.
       Copying	and  distribution  of this file, with or without modification,
       are permitted in	any medium without royalty provided the	copyright  no-
       tice and	this notice are	preserved.

SEE ALSO
       The  full  documentation	for libidn2 is maintained as a Texinfo manual.
       If the info and libidn2 programs	are properly installed at  your	 site,
       the command

	      info libidn2

       should  give  you access	to the complete	manual.	 As an alternative you
       may obtain the manual from:

	      https://www.gnu.org/software/libidn/libidn2/manual/

libidn2				     2.3.8		   idn2_to_ascii_8z(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=idn2_to_ascii_8z&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help