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-2013 Simon Josefsson.
65       Copying  and  distribution  of this file, with or without modification,
66       are permitted in any medium  without  royalty  provided  the  copyright
67       notice and this notice are preserved.
68

SEE ALSO

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