1idn2_to_ascii_4i(3)                 libidn2                idn2_to_ascii_4i(3)
2
3
4

NAME

6       idn2_to_ascii_4i - API function
7

SYNOPSIS

9       #include <idn2.h>
10
11       int  idn2_to_ascii_4i(const uint32_t * input, size_t inlen, char * out‐
12       put, int flags);
13

ARGUMENTS

15       const uint32_t * input
16                   zero terminated input Unicode (UCS-4) string.
17
18       size_t inlen
19                   number of elements in  input .
20
21       char * output
22                   output zero terminated string that must have  room  for  at
23                   least 63 characters plus the terminating zero.
24
25       int flags   optional idn2_flags to modify behaviour.
26

DESCRIPTION

28       THIS   FUNCTION   HAS  BEEN  DEPRECATED  DUE  TO  A  DESIGN  FLAW.  USE
29       idn2_to_ascii_4i2() INSTEAD !
30
31       The ToASCII operation takes a sequence of Unicode code points that make
32       up one domain label and transforms it into a sequence of code points in
33       the ASCII range (0..7F). If ToASCII succeeds, the original sequence and
34       the resulting sequence are equivalent labels.
35
36       It  is  important to note that the ToASCII operation can fail.  ToASCII
37       fails if any step of it fails. If any step  of  the  ToASCII  operation
38       fails  on any label in a domain name, that domain name MUST NOT be used
39       as an internationalized domain name.  The method for dealing with  this
40       failure is application-specific.
41
42       The inputs to ToASCII are a sequence of code points.
43
44       ToASCII  never  alters  a  sequence  of code points that are all in the
45       ASCII range to begin  with  (although  it  could  fail).  Applying  the
46       ToASCII operation multiple effect as applying it just once.
47
48       The default behavior of this function (when flags are zero) is to apply
49       the IDNA2008 rules without the TR46 amendments. As the TR46 non-transi‐
50       tional  processing  is  nowadays  ubiquitous, when unsure, it is recom‐
51       mended to call this function  with  the  IDN2_NONTRANSITIONAL  and  the
52       IDN2_NFC_INPUT flags for compatibility with other software.
53
54       Return value: Returns IDN2_OK on success, or error code.
55

SINCE

57       2.0.0
58

DEPRECATED

60       2.1.1: Use idn2_to_ascii_4i2().
61

REPORTING BUGS

63       Report bugs to <help-libidn@gnu.org>.
64       General guidelines for reporting bugs: https://www.gnu.org/gethelp/
65       Libidn2 home page: https://www.gnu.org/software/libidn2/
66
67
69       Copyright © 2002-2022 Simon Josefsson.
70       Copying  and  distribution  of this file, with or without modification,
71       are permitted in any medium without royalty provided the copyright  no‐
72       tice and this notice are preserved.
73

SEE ALSO

75       The  full  documentation for libidn2 is maintained as a Texinfo manual.
76       If the info and libidn2 programs are properly installed at  your  site,
77       the command
78
79              info libidn2
80
81       should  give  you access to the complete manual.  As an alternative you
82       may obtain the manual from:
83
84              https://www.gnu.org/software/libidn/libidn2/manual/
85
86libidn2                              2.3.4                 idn2_to_ascii_4i(3)
Impressum