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 <bug-libidn@gnu.org>.
       General guidelines for reporting	bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/

COPYRIGHT
       Copyright (C) 2002-2016 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:

	      http://www.gnu.org/software/libidn/manual/

libidn				     1.34		idna_to_unicode_44i(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | REPORTING BUGS | COPYRIGHT | SEE ALSO

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

home | help