1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/* idna.h --- Prototypes for Internationalized Domain Name library.
Copyright (C) 2002-2024 Simon Josefsson
This file is part of GNU Libidn.
GNU Libidn is free software: you can redistribute it and/or
modify it under the terms of either:
* the GNU Lesser General Public License as published by the Free
Software Foundation; either version 3 of the License, or (at
your option) any later version.
or
* the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at
your option) any later version.
or both in parallel, as here.
GNU Libidn is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received copies of the GNU General Public License and
the GNU Lesser General Public License along with this program. If
not, see <https://www.gnu.org/licenses/>. */
#ifndef IDNA_H
# define IDNA_H
/**
* SECTION:idna
* @title: idna.h
* @short_description: IDNA-related functions
*
* IDNA-related functions.
*/
/**
* IDNAPI:
*
* Symbol holding shared library API visibility decorator.
*
* This is used internally by the library header file and should never
* be used or modified by the application.
*
* https://www.gnu.org/software/gnulib/manual/html_node/Exported-Symbols-of-Shared-Libraries.html
*/
# ifndef IDNAPI
# define IDNAPI
# endif
# include <stddef.h> /* size_t */
# include "idn-int.h" /* uint32_t */
# ifdef __cplusplus
extern "C"
{
# endif
/* Error codes. */
typedef enum
{
IDNA_SUCCESS = 0,
IDNA_STRINGPREP_ERROR = 1,
IDNA_PUNYCODE_ERROR = 2,
IDNA_CONTAINS_NON_LDH = 3,
/* Workaround typo in earlier versions. */
IDNA_CONTAINS_LDH = IDNA_CONTAINS_NON_LDH,
IDNA_CONTAINS_MINUS = 4,
IDNA_INVALID_LENGTH = 5,
IDNA_NO_ACE_PREFIX = 6,
IDNA_ROUNDTRIP_VERIFY_ERROR = 7,
IDNA_CONTAINS_ACE_PREFIX = 8,
IDNA_ICONV_ERROR = 9,
/* Internal errors. */
IDNA_MALLOC_ERROR = 201,
IDNA_DLOPEN_ERROR = 202
} Idna_rc;
/* IDNA flags */
typedef enum
{
IDNA_ALLOW_UNASSIGNED = 0x0001,
IDNA_USE_STD3_ASCII_RULES = 0x0002
} Idna_flags;
# ifndef IDNA_ACE_PREFIX
# define IDNA_ACE_PREFIX "xn--"
# endif
# ifndef IDNA_LABEL_MAX_LENGTH
# define IDNA_LABEL_MAX_LENGTH 255
# endif
extern IDNAPI const char *idna_strerror (Idna_rc rc);
/* Core functions */
extern IDNAPI int idna_to_ascii_4i (const uint32_t * in, size_t inlen,
char *out, int flags);
extern IDNAPI int idna_to_unicode_44i (const uint32_t * in, size_t inlen,
uint32_t * out, size_t *outlen,
int flags);
/* Wrappers that handle several labels */
extern IDNAPI int idna_to_ascii_4z (const uint32_t * input,
char **output, int flags);
extern IDNAPI int idna_to_ascii_8z (const char *input, char **output,
int flags);
extern IDNAPI int idna_to_ascii_lz (const char *input, char **output,
int flags);
extern IDNAPI int idna_to_unicode_4z4z (const uint32_t * input,
uint32_t ** output, int flags);
extern IDNAPI int idna_to_unicode_8z4z (const char *input,
uint32_t ** output, int flags);
extern IDNAPI int idna_to_unicode_8z8z (const char *input,
char **output, int flags);
extern IDNAPI int idna_to_unicode_8zlz (const char *input,
char **output, int flags);
extern IDNAPI int idna_to_unicode_lzlz (const char *input,
char **output, int flags);
# ifdef __cplusplus
}
# endif
#endif /* IDNA_H */
|
