1idna_to_unicode_44i(3)              libidn              idna_to_unicode_44i(3)
2
3
4

NAME

6       idna_to_unicode_44i - API function
7

SYNOPSIS

9       #include <idna.h>
10
11       int  idna_to_unicode_44i(const  uint32_t * in, size_t inlen, uint32_t *
12       out, size_t * outlen, int flags);
13

ARGUMENTS

15       const uint32_t * in
16                   input array with unicode code points.
17
18       size_t inlen
19                   length of input array with unicode code points.
20
21       uint32_t * out
22                   output array with unicode code points.
23
24       size_t * outlen
25                   on input, maximum size of output array  with  unicode  code
26                   points,  on  exit, actual size of output array with unicode
27                   code points.
28
29       int flags   an  Idna_flags  value,   e.g.,   IDNA_ALLOW_UNASSIGNED   or
30                   IDNA_USE_STD3_ASCII_RULES.
31

DESCRIPTION

33       The  ToUnicode  operation  takes a sequence of Unicode code points that
34       make up one domain label and returns a sequence of Unicode code points.
35       If  the  input  sequence  is a label in ACE form, then the result is an
36       equivalent internationalized label that is not in ACE  form,  otherwise
37       the original sequence is returned unaltered.
38
39       ToUnicode  never  fails.  If  any  step  fails, then the original input
40       sequence is returned immediately in that step.
41
42       The Punycode decoder can never output more code points than it  inputs,
43       but Nameprep can, and therefore ToUnicode can.  Note that the number of
44       octets needed to represent a sequence of code  points  depends  on  the
45       particular character encoding used.
46
47       The  inputs  to ToUnicode are a sequence of code points, the AllowUnas‐
48       signed flag, and the UseSTD3ASCIIRules flag. The output of ToUnicode is
49       always a sequence of Unicode code points.
50

RETURN VALUE

52       Returns Idna_rc error condition, but it must only be used for debugging
53       purposes.  The output buffer is always guaranteed to contain  the  cor‐
54       rect  data according to the specification (sans malloc induced errors).
55       NB!  This means that you normally ignore  the  return  code  from  this
56       function, as checking it means breaking the standard.
57

REPORTING BUGS

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

64       Copyright  © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Simon
65       Josefsson.
66       Copying and distribution of this file, with  or  without  modification,
67       are  permitted  in  any  medium  without royalty provided the copyright
68       notice and this notice are preserved.
69

SEE ALSO

71       The full documentation for libidn is maintained as  a  Texinfo  manual.
72       If  the  info  and libidn programs are properly installed at your site,
73       the command
74
75              info libidn
76
77       should give you access to the complete manual.
78
79
80
81libidn                               1.18               idna_to_unicode_44i(3)
Impressum