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

FreeBSD Manual Pages

  
 
  

home | help
idn2_to_ascii_4z(3)		    libidn2		   idn2_to_ascii_4z(3)

NAME
       idn2_to_ascii_4z	- API function

SYNOPSIS
       #include	<idn2.h>

       int  idn2_to_ascii_4z(const  uint32_t  *	 input,	 char  **  output, int
       flags);

ARGUMENTS
       const uint32_t *	input
		   zero	terminated input Unicode (UCS-4) string.

       char ** output
		   pointer to newly allocated zero-terminated output string.

       int flags   optional idn2_flags to modify behaviour.

DESCRIPTION
       Convert UCS-4 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_4z(3)

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

home | help