]>
Commit | Line | Data |
---|---|---|
01859b1c UD |
1 | /* idna.h Declarations for IDNA. |
2 | * Copyright (C) 2002, 2003, 2004 Simon Josefsson | |
3 | * | |
4 | * This file is part of GNU Libidn. | |
5 | * | |
6 | * GNU Libidn is free software; you can redistribute it and/or | |
7 | * modify it under the terms of the GNU Lesser General Public | |
8 | * License as published by the Free Software Foundation; either | |
9 | * version 2.1 of the License, or (at your option) any later version. | |
10 | * | |
11 | * GNU Libidn is distributed in the hope that it will be useful, | |
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 | * Lesser General Public License for more details. | |
15 | * | |
16 | * You should have received a copy of the GNU Lesser General Public | |
59ba27a6 | 17 | * License along with GNU Libidn; if not, see <http://www.gnu.org/licenses/>. |
01859b1c UD |
18 | */ |
19 | ||
20 | #ifndef _IDNA_H | |
21 | #define _IDNA_H | |
22 | ||
23 | #ifdef __cplusplus | |
24 | extern "C" | |
25 | { | |
26 | #endif | |
27 | ||
28 | #include <stddef.h> /* size_t */ | |
29 | #include <stdint.h> /* uint32_t */ | |
30 | ||
31 | /* Error codes. */ | |
32 | typedef enum | |
33 | { | |
34 | IDNA_SUCCESS = 0, | |
35 | IDNA_STRINGPREP_ERROR = 1, | |
36 | IDNA_PUNYCODE_ERROR = 2, | |
37 | IDNA_CONTAINS_NON_LDH = 3, | |
38 | /* Workaround typo in earlier versions. */ | |
39 | IDNA_CONTAINS_LDH = IDNA_CONTAINS_NON_LDH, | |
40 | IDNA_CONTAINS_MINUS = 4, | |
41 | IDNA_INVALID_LENGTH = 5, | |
42 | IDNA_NO_ACE_PREFIX = 6, | |
43 | IDNA_ROUNDTRIP_VERIFY_ERROR = 7, | |
44 | IDNA_CONTAINS_ACE_PREFIX = 8, | |
45 | IDNA_ICONV_ERROR = 9, | |
46 | /* Internal errors. */ | |
47 | IDNA_MALLOC_ERROR = 201, | |
48 | IDNA_DLOPEN_ERROR = 202 | |
49 | } Idna_rc; | |
50 | ||
51 | /* IDNA flags */ | |
52 | typedef enum | |
53 | { | |
54 | IDNA_ALLOW_UNASSIGNED = 0x0001, | |
55 | IDNA_USE_STD3_ASCII_RULES = 0x0002 | |
56 | } Idna_flags; | |
57 | ||
58 | #ifndef IDNA_ACE_PREFIX | |
59 | #define IDNA_ACE_PREFIX "xn--" | |
60 | #endif | |
61 | ||
62 | /* Core functions */ | |
63 | extern int idna_to_ascii_4i (const uint32_t * in, size_t inlen, | |
64 | char *out, int flags); | |
65 | extern int idna_to_unicode_44i (const uint32_t * in, size_t inlen, | |
66 | uint32_t * out, size_t * outlen, int flags); | |
67 | ||
68 | /* Wrappers that handle several labels */ | |
69 | ||
70 | extern int idna_to_ascii_4z (const uint32_t * input, | |
71 | char **output, int flags); | |
72 | ||
73 | extern int idna_to_ascii_8z (const char *input, char **output, int flags); | |
74 | ||
75 | extern int idna_to_ascii_lz (const char *input, char **output, int flags); | |
76 | ||
77 | ||
78 | extern int idna_to_unicode_4z4z (const uint32_t * input, | |
79 | uint32_t ** output, int flags); | |
80 | ||
81 | extern int idna_to_unicode_8z4z (const char *input, | |
82 | uint32_t ** output, int flags); | |
83 | ||
84 | extern int idna_to_unicode_8z8z (const char *input, | |
85 | char **output, int flags); | |
86 | ||
87 | extern int idna_to_unicode_8zlz (const char *input, | |
88 | char **output, int flags); | |
89 | ||
90 | extern int idna_to_unicode_lzlz (const char *input, | |
91 | char **output, int flags); | |
92 | ||
93 | #ifdef __cplusplus | |
94 | } | |
95 | #endif | |
96 | #endif /* _PUNYCODE_H */ |