Manual Pages for UNIX Operating System command usage for man idna_to_unicode_44i

libidn                                     idna_to_unicode_44i(3)



NAME
     idna_to_unicode_44i - convert domain name label to Unicode

SYNOPSIS
     #include 

     int idna_to_unicode_44i(const uint32_t * in,  size_t  inlen,
     uint32_t * out

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



libidn                  Last change: 1.9                        1






libidn                                     idna_to_unicode_44i(3)



     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 function,
     as checking it means breaking the standard.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright cO 2002, 2003, 2004, 2005, 2006, 2007,  2008  Simon
     Josefsson.
     Permission is granted to make and distribute verbatim copies
     of  this  manual provided the copyright notice and this per-
     mission notice are preserved on all copies.

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.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  library/libidn |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for LibIDN is available on http://opensolaris.org.

















libidn                  Last change: 1.9                        2