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

NAME

6       idna_to_unicode_44i - convert domain name label to Unicode
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 label and returns a sequence of Unicode code points. If the
35       input sequence is a label in ACE form, then the result is an equivalent
36       internationalized label that is not in ACE form, otherwise the original
37       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>.
60

62       Copyright © 2002, 2003, 2004, 2005, 2006 Simon Josefsson.
63       Permission  is  granted  to make and distribute verbatim copies of this
64       manual provided the copyright notice and  this  permission  notice  are
65       preserved on all copies.
66

SEE ALSO

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