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 se‐
40       quence 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
51       Return value: Returns Idna_rc error condition, but it must only be used
52       for debugging purposes.  The output buffer is always guaranteed to con‐
53       tain  the  correct data according to the specification (sans malloc in‐
54       duced errors).  NB!  This means that you  normally  ignore  the  return
55       code from this function, as checking it means breaking the standard.
56

REPORTING BUGS

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

64       Copyright © 2002-2021 Simon Josefsson.
65       Copying  and  distribution  of this file, with or without modification,
66       are permitted in any medium without royalty provided the copyright  no‐
67       tice 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.  As an alternative you
77       may obtain the manual from:
78
79              http://www.gnu.org/software/libidn/manual/
80
81libidn                               1.38               idna_to_unicode_44i(3)
Impressum