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 inlenlength 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 in-
     ternationalized  label  that is not in ACE form, otherwise the original se-
     quence is returned unaltered.

     ToUnicode never fails. If any step fails, then the original input	sequence
     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  AllowUnassigned
     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 contain  the
     correct  data  according to the specification (sans malloc induced errors).
     NB!  This means that you normally ignore the return code  from  this  func-
     tion, 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  notice  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  com-
     mand

	    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+15.1.quarterly>

home | help