idna_to_ascii_4i

a b c d e f g h i j k l m n o p q r s t u v w x y z _
idna_to_ascii_4i(3)		    libidn		  idna_to_ascii_4i(3)



NAME
       idna_to_ascii_4i

SYNOPSIS
       #include <idna.h>

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

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 terminating zero.

       int flags	IDNA	flags,	  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 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 AllowUnas-
       signed 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 apply-
       ing it just once.

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

REPORTING BUGS
       Report bugs to <bug-libidn@gnu.org>.

COPYRIGHT
       Copyright © 2002, 2003, 2004 Simon Josefsson.
       Permission is granted to make and distribute verbatim copies  of	 this
       manual  provided	 the  copyright notice and this permission 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.



libidn				    0.5.6		  idna_to_ascii_4i(3)