Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

idna_to_unicode_44i (3)

Name

idna_to_unicode_44i - API function

Synopsis

#include <idna.h>

int  idna_to_unicode_44i(const  uint32_t * in, size_t inlen, uint32_t *
out, size_t * outlen, int flags);

Description

idna_to_unicode_44i(3)              libidn              idna_to_unicode_44i(3)



NAME
       idna_to_unicode_44i - API function

SYNOPSIS
       #include <idna.h>

       int  idna_to_unicode_44i(const  uint32_t * in, size_t inlen, uint32_t *
       out, size_t * outlen, int flags);

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 AllowUnas-
       signed 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 guaranteed to con-
       tain  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 <bug-libidn@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/


COPYRIGHT
       Copyright (C) 2002-2016 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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libidn   |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
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.  As an alternative you
       may obtain the manual from:

              http://www.gnu.org/software/libidn/manual/

NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/libidn/libidn-1.34.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libidn.



libidn                               1.34               idna_to_unicode_44i(3)