Manual Pages for UNIX Operating System command usage for man idna_to_ascii_4i

libidn                                        idna_to_ascii_4i(3)



NAME
     idna_to_ascii_4i - convert Unicode domain name label to text

SYNOPSIS
     #include 

     int idna_to_ascii_4i(const uint32_t * in, size_t inlen, char
     * out

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

     size_t inlen
                 length of input array with unicode code points.

     char * out  output zero terminated  string  that  must  have
                 room  for  at  least 63 characters plus the ter-
                 minating zero.

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

DESCRIPTION
     The ToASCII operation  takes  a  sequence  of  Unicode  code
     points  that make up one domain label and transforms it into
     a sequence of code points in the  ASCII  range  (0..7F).  If
     ToASCII  succeeds,  the  original sequence and the resulting
     sequence are equivalent labels.

     It is important to note that the ToASCII operation can fail.
     ToASCII  fails  if  any step of it fails. If any step of the
     ToASCII operation fails on any label in a domain name,  that
     domain  name MUST NOT be used as an internationalized domain
     name.  The  method  for  deadling  with  this   failure   is
     application-specific.

     The inputs to ToASCII are a sequence  of  code  points,  the
     AllowUnassigned  flag,  and  the UseSTD3ASCIIRules flag. The
     output of ToASCII is either a sequence of ASCII code  points
     or a failure condition.

     ToASCII never alters a sequence of code points that are  all
     in  the  ASCII range to begin with (although it could fail).
     Applying the ToASCII operation multiple  times  has  exactly
     the same effect as applying it just once.

RETURN VALUE
     Returns 0 on success, or an Idna_rc error code.

REPORTING BUGS
     Report bugs to .



libidn                  Last change: 1.9                        1






libidn                                        idna_to_ascii_4i(3)



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