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

FreeBSD Manual Pages

  
 
  

home | help
idna_to_unicode_44i(3)		    libidn		idna_to_unicode_44i(3)

NAME
       idna_to_unicode_44i - API function

SYNOPSIS
       #include	<idna.h>

       int  idna_to_unicode_44i(const  uint32_t	* in, size_t inlen, uint32_t *
       out, size_t * outlen, int flags);

ARGUMENTS
       const uint32_t *	in
		   input array with unicode code points.

       size_t inlen
		   length of input array with unicode code points.

       uint32_t	* out
		   output array	with unicode code points.

       size_t *	outlen
		   on input, maximum size of output array  with	 unicode  code
		   points,  on	exit, actual size of output array with unicode
		   code	points.

       int flags   an  Idna_flags  value,   e.g.,   IDNA_ALLOW_UNASSIGNED   or
		   IDNA_USE_STD3_ASCII_RULES.

DESCRIPTION
       The  ToUnicode  operation  takes	a sequence of Unicode code points that
       make up one domain label	and returns a sequence of Unicode code points.
       If the input sequence is	a label	in ACE form, then  the	result	is  an
       equivalent  internationalized  label that is not	in ACE form, otherwise
       the original sequence is	returned unaltered.

       ToUnicode never fails. If any step fails, then the original  input  se-
       quence is returned immediately in that step.

       The  Punycode decoder can never output more code	points than it inputs,
       but Nameprep can, and therefore ToUnicode can.  Note that the number of
       octets needed to	represent a sequence of	code  points  depends  on  the
       particular character encoding used.

       The  inputs  to ToUnicode are a sequence	of code	points,	the AllowUnas-
       signed flag, and	the UseSTD3ASCIIRules flag. The	output of ToUnicode is
       always a	sequence of Unicode code points.

       Return value: Returns Idna_rc error condition, but it must only be used
       for debugging purposes.	The output buffer is always guaranteed to con-
       tain the	correct	data according to the specification (sans  malloc  in-
       duced  errors).	 NB!   This  means that	you normally ignore the	return
       code from this function,	as checking it means breaking the standard.

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

libidn				     1.43		idna_to_unicode_44i(3)

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

home | help