libidn                                     idnatounicode44i(3)



NAME
     idnatounicode44i - convert domain name label to Unicode

SYNOPSIS
     #include 

     int idnatounicode44i(const uint32t * in,  sizet  inlen,
     uint32t * out

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

     sizet inlen
                 length of input array with unicode code points.

     uint32t * out
                 output array with unicode code points.

     sizet * 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 Idnaflags value, e.g., IDNALOWUNASIGNED
                 or IDNAUSESTD3ASCIRULES.

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 UseSTD3ASCIRules flag. The
     output of ToUnicode is always a  sequence  of  Unicode  code
     points.

RETURN VALUE
     Returns Idnarc error condition, but it must  only  be  used
     for   debugging  purposes.   The  output  buffer  is  always



libidn                  Last change: 1.9                        1






libidn                                     idnatounicode44i(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 O 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.

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

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWlibidn     
    
     Interface Stability  Uncommitted    
    

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

















libidn                  Last change: 1.9                        2