Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   11224 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

punycode_decode(3)		    libidn		    punycode_decode(3)

NAME
       punycode_decode - API function

SYNOPSIS
       #include <punycode.h>

       int  punycode_decode(size_t input_length, const char [] input, size_t *
       output_length, punycode_uint [] output, unsigned char [] case_flags);

ARGUMENTS
       size_t input_length
		   The number of ASCII code points in the input array.

       const char [] input
		   An array of ASCII code points (0..7F).

       size_t * output_length
		   The caller passes in the maximum number of code points that
		   it  can  receive  into  the output array (which is also the
		   maximum number of  flags  that  it  can  receive  into  the
		   case_flags array, if case_flags is not a NULL pointer).  On
		   successful return it will contain the number of code points
		   actually output (which is also the number of flags actually
		   output, if case_flags is not a null pointer).  The  decoder
		   will	 never need to output more code points than the number
		   of ASCII code points in the input, because of the  way  the
		   encoding is defined.	 The number of code points output can‐
		   not exceed the maximum possible value of  a	punycode_uint,
		   even if the supplied output_length is greater than that.

       punycode_uint [] output
		   An  array  of  code points like the input argument of puny‐
		   code_encode() (see above).

       unsigned char [] case_flags
		   A NULL pointer (if the flags are not needed by the  caller)
		   or an array of boolean values parallel to the output array.
		   Nonzero (true, flagged)  suggests  that  the	 corresponding
		   Unicode  character be forced to uppercase by the caller (if
		   possible), and zero (false, unflagged) suggests that it  be
		   forced  to  lowercase  (if  possible).   ASCII  code points
		   (0..7F) are output already in the proper  case,  but	 their
		   flags  will be set appropriately so that applying the flags
		   would be harmless.

DESCRIPTION
       Converts Punycode to a sequence of code points (presumed to be  Unicode
       code points).

RETURN VALUE
       The  return  value  can	be  any	 of the Punycode_status values defined
       above.	If  not	 PUNYCODE_SUCCESS,  then  output_length,  output,  and
       case_flags might contain garbage.

REPORTING BUGS
       Report	bugs   to   <bug-libidn@gnu.org>.    GNU   Libidn  home	 page:
       http://www.gnu.org/software/libidn/ General help	 using	GNU  software:
       http://www.gnu.org/gethelp/

COPYRIGHT
       Copyright © 2002-2013 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 command

	      info libidn

       should give you access to the complete manual.

libidn				     1.28		    punycode_decode(3)

Vote for polarhome