|
1 | 1 | # C++ Plus NLS Util language map for cppp-reiconv. |
2 | 2 | # en_US |
3 | 3 |
|
4 | | -''' |
5 | | -/* Copyright (C) 1999-2023 Free Software Foundation, Inc. |
6 | | - This file is part of the cppp-reiconv library. |
7 | | - |
8 | | - The cppp-reiconv library is free software; you can redistribute it |
9 | | - and/or modify it under the terms of the GNU Lesser General Public |
10 | | - License as published by the Free Software Foundation; either version 3 |
11 | | - of the License, or (at your option) any later version. |
12 | | - |
13 | | - The cppp-reiconv library is distributed in the hope that it will be |
14 | | - useful, but WITHOUT ANY WARRANTY; without even the implied warranty of |
15 | | - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
16 | | - Lesser General Public License for more details. |
17 | | - |
18 | | - You should have received a copy of the GNU Lesser General Public |
19 | | - License along with the cppp-reiconv library; see the file COPYING. |
20 | | - If not, see <https://www.gnu.org/licenses/>. */ |
21 | | -''' |
22 | | -/* Copyright (C) 1999-2023 Free Software Foundation, Inc. |
23 | | - This file is part of the cppp-reiconv library. |
24 | | - |
25 | | - The cppp-reiconv library is free software; you can redistribute it |
26 | | - and/or modify it under the terms of the GNU Lesser General Public |
27 | | - License as published by the Free Software Foundation; either version 3 |
28 | | - of the License, or (at your option) any later version. |
29 | | - |
30 | | - The cppp-reiconv library is distributed in the hope that it will be |
31 | | - useful, but WITHOUT ANY WARRANTY; without even the implied warranty of |
32 | | - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
33 | | - Lesser General Public License for more details. |
34 | | - |
35 | | - You should have received a copy of the GNU Lesser General Public |
36 | | - License along with the cppp-reiconv library; see the file COPYING. |
37 | | - If not, see <https://www.gnu.org/licenses/>. */ |
38 | | -''' |
39 | | - |
40 | | -''' |
41 | | -/* When installed, this file is called "cppp/reiconv.hpp". */ |
42 | | -''' |
43 | | -/* When installed, this file is called "cppp/reiconv.hpp". */ |
44 | | -''' |
45 | | - |
46 | | -''' |
47 | | -/* Use UTF-8 to decode this file. */ |
48 | | -''' |
49 | | -/* Use UTF-8 to decode this file. */ |
50 | | -''' |
51 | | - |
52 | | -''' |
53 | | - /** |
54 | | - * @brief Version infomation. (major<<8) + minor |
55 | | - */ |
56 | | -''' |
57 | | - /** |
58 | | - * @brief Version infomation. (major<<8) + minor |
59 | | - */ |
60 | | -''' |
61 | | - |
62 | | -''' |
63 | | - /** |
64 | | - * @typedef void* |
65 | | - * @brief Identifier for conversion method from one codeset to another. |
66 | | - */ |
67 | | -''' |
68 | | - /** |
69 | | - * @typedef void* |
70 | | - * @brief Identifier for conversion method from one codeset to another. |
71 | | - */ |
72 | | -''' |
73 | | - |
74 | | -''' |
75 | | - /** |
76 | | - * @brief Allocates descriptor for code conversion from encoding 'fromcode' to encoding 'tocode'. |
77 | | - * @param tocode Target encoding. |
78 | | - * @param fromcode From encoding. |
79 | | - * @return Allocated iconv conversation buffer's pointer. |
80 | | - */ |
81 | | -''' |
82 | | - /** |
83 | | - * @brief Allocates descriptor for code conversion from encoding 'fromcode' to encoding 'tocode'. |
84 | | - * @param tocode Target encoding. |
85 | | - * @param fromcode From encoding. |
86 | | - * @return Allocated iconv conversation buffer's pointer. |
87 | | - */ |
88 | | -''' |
89 | | - |
90 | | -''' |
91 | | - /** |
92 | | - * @brief Converts, using conversion descriptor 'cd', at most '*inbytesleft' bytes starting at '*inbuf', writing at most '*outbytesleft' bytes starting at '*outbuf'. |
93 | | - * @attention Decrements '*inbytesleft' and increments '*inbuf' by the same amount. |
94 | | - * @attention Decrements '*outbytesleft' and increments '*outbuf' by the same amount. |
95 | | - * @param cd Conversion descriptor. |
96 | | - * @param inbuf Input buffer. |
97 | | - * @param inbytesleft Input bytes left. |
98 | | - * @param outbuf Output buffer. |
99 | | - * @param outbytesleft Output bytes left. |
100 | | - * @return Number of converted characters (excluding terminators, -1 means error). |
101 | | - */ |
102 | | -''' |
103 | | - /** |
104 | | - * @brief Converts, using conversion descriptor 'cd', at most '*inbytesleft' bytes starting at '*inbuf', writing at most '*outbytesleft' bytes starting at '*outbuf'. |
105 | | - * @attention Decrements '*inbytesleft' and increments '*inbuf' by the same amount. |
106 | | - * @attention Decrements '*outbytesleft' and increments '*outbuf' by the same amount. |
107 | | - * @param cd Conversion descriptor. |
108 | | - * @param inbuf Input buffer. |
109 | | - * @param inbytesleft Input bytes left. |
110 | | - * @param outbuf Output buffer. |
111 | | - * @param outbytesleft Output bytes left. |
112 | | - * @return Number of converted characters (excluding terminators, -1 means error). |
113 | | - */ |
114 | | -''' |
115 | | - |
116 | | -''' |
117 | | - /** |
118 | | - * @brief Frees resources allocated for conversion descriptor 'cd'. |
119 | | - * @param cd Conversion descriptor you want to close. |
120 | | - * @return Operation status. (-1 means error, 0 means success). |
121 | | - */ |
122 | | -''' |
123 | | - /** |
124 | | - * @brief Frees resources allocated for conversion descriptor 'cd'. |
125 | | - * @param cd Conversion descriptor you want to close. |
126 | | - * @return Operation status. (-1 means error, 0 means success). |
127 | | - */ |
128 | | -''' |
129 | | - |
130 | | -''' |
131 | | - /** |
132 | | - * @brief Control of attributes. |
133 | | - * @param cd Conversion descriptor. |
134 | | - * @param request Attribute request id. |
135 | | - * @param argument Attribute argument. |
136 | | - * @return Operation status (>=0 means success, <0 means error). |
137 | | - */ |
138 | | -''' |
139 | | - /** |
140 | | - * @brief Control of attributes. |
141 | | - * @param cd Conversion descriptor. |
142 | | - * @param request Attribute request id. |
143 | | - * @param argument Attribute argument. |
144 | | - * @return Operation status (>=0 means success, <0 means error). |
145 | | - */ |
146 | | -''' |
147 | | - |
148 | | -''' |
149 | | - /** |
150 | | - * @typedef void (*) (unsigned int, void*) |
151 | | - * @brief Hook performed after every successful conversion of a Unicode character. |
152 | | - */ |
153 | | -''' |
154 | | - /** |
155 | | - * @typedef void (*) (unsigned int, void*) |
156 | | - * @brief Hook performed after every successful conversion of a Unicode character. |
157 | | - */ |
158 | | -''' |
159 | | - |
160 | | -''' |
161 | | - /** |
162 | | - * @brief Set of hooks. |
163 | | - */ |
164 | | -''' |
165 | | - /** |
166 | | - * @brief Set of hooks. |
167 | | - */ |
168 | | -''' |
169 | | - |
170 | | -''' |
171 | | - /** |
172 | | - * @brief Fallback function. Invoked when a small number of bytes could not be |
173 | | - * converted to a Unicode character. This function should process all |
174 | | - * bytes from inbuf and may produce replacement Unicode characters by calling |
175 | | - * the write_replacement callback repeatedly. |
176 | | - */ |
177 | | -''' |
178 | | - /** |
179 | | - * @brief Fallback function. Invoked when a small number of bytes could not be |
180 | | - * converted to a Unicode character. This function should process all |
181 | | - * bytes from inbuf and may produce replacement Unicode characters by calling |
182 | | - * the write_replacement callback repeatedly. |
183 | | - */ |
184 | | -''' |
185 | | - |
186 | | -''' |
187 | | - /** |
188 | | - * @brief Fallback function. Invoked when a Unicode character could not be converted |
189 | | - * to the target encoding. This function should process the character and |
190 | | - * may produce replacement bytes (in the target encoding) by calling the |
191 | | - * write_replacement callback repeatedly. |
192 | | - */ |
193 | | -''' |
194 | | - /** |
195 | | - * @brief Fallback function. Invoked when a Unicode character could not be converted |
196 | | - * to the target encoding. This function should process the character and |
197 | | - * may produce replacement bytes (in the target encoding) by calling the |
198 | | - * write_replacement callback repeatedly. |
199 | | - */ |
200 | | -''' |
201 | | - |
202 | | -''' |
203 | | - /** |
204 | | - * @brief Set of fallbacks. |
205 | | - */ |
206 | | -''' |
207 | | - /** |
208 | | - * @brief Set of fallbacks. |
209 | | - */ |
210 | | -''' |
211 | | - |
212 | | -''' |
213 | | - /** |
214 | | - * @brief Surfaces. The concept of surfaces is described in the 'recode' manual. |
215 | | - */ |
216 | | -''' |
217 | | - /** |
218 | | - * @brief Surfaces. The concept of surfaces is described in the 'recode' manual. |
219 | | - */ |
220 | | -''' |
221 | | - |
222 | | -''' |
223 | | - /** |
224 | | - * @brief In EBCDIC encodings, 0x15 (which encodes the "newline function", see the |
225 | | - * Unicode standard, chapter 5) maps to U+000A instead of U+0085. This is |
226 | | - * for interoperability with C programs and Unix environments on z/OS. |
227 | | - */ |
228 | | -''' |
229 | | - /** |
230 | | - * @brief In EBCDIC encodings, 0x15 (which encodes the "newline function", see the |
231 | | - * Unicode standard, chapter 5) maps to U+000A instead of U+0085. This is |
232 | | - * for interoperability with C programs and Unix environments on z/OS. |
233 | | - */ |
234 | | -''' |
235 | | - |
236 | | -''' |
237 | | - /** |
238 | | - * @brief Request for iconvctl. |
239 | | - */ |
240 | | -''' |
241 | | - /** |
242 | | - * @brief Request for iconvctl. |
243 | | - */ |
244 | | -''' |
245 | | - |
246 | | -''' |
247 | | - /** |
248 | | - * @brief Listing of locale independent encodings. |
249 | | - * @param do_one One encoding fallback function. |
250 | | - * @param data Data. |
251 | | - */ |
252 | | -''' |
253 | | - /** |
254 | | - * @brief Listing of locale independent encodings. |
255 | | - * @param do_one One encoding fallback function. |
256 | | - * @param data Data. |
257 | | - */ |
258 | | -''' |
259 | | - |
260 | | -''' |
261 | | - /** |
262 | | - * @brief Converts an entire string from one encoding to another, using iconv. Easier to use than iconv() itself, and supports autodetect encodings on input when extra features enabled. |
263 | | - * |
264 | | - * @note Converts a memory region given in encoding FROMCODE to a new memory |
265 | | - * region in encoding TOCODE. FROMCODE and TOCODE are as for iconv_open(3), |
266 | | - * except that FROMCODE may be one of the values **when enabled extra features**. |
267 | | - * |
268 | | - * @note "autodetect_utf8" supports ISO-8859-1 and UTF-8 |
269 | | - * @note "autodetect_jp" supports EUC-JP, ISO-2022-JP-2 and SHIFT_JIS |
270 | | - * @note "autodetect_kr" supports EUC-KR and ISO-2022-KR |
271 | | - * @note The input is in the memory region between start (inclusive) and end |
272 | | - * (exclusive). If resultp is not NULL, the output string is stored in |
273 | | - * *resultp; malloc/realloc is used to allocate the result. |
274 | | - * |
275 | | - * @note This function does not treat zero characters specially. |
276 | | - * |
277 | | - * @param tocode Target encoding. |
278 | | - * @param fromcode From encoding. |
279 | | - * @param start Source string start pointer. |
280 | | - * @param end Source string end pointer. |
281 | | - * @param resultp Result memory pointer. |
282 | | - * @param lengthp Pointer to a variable that stores the length of the result. |
283 | | - * @return Return 0 if successful, otherwise -1 and errno set. Particular errno values: EILSEQ and ENOMEM. |
284 | | - * |
285 | | - * @example |
286 | | - * const char* s = ...; |
287 | | - * char* result = NULL; |
288 | | - * if (iconv_string("UCS-4-INTERNAL", "GBK", |
289 | | - * s, s+strlen(s)+1, &result, NULL) < 0) |
290 | | - * perror("iconv_string"); |
291 | | - * |
292 | | - */ |
293 | | -''' |
294 | | - /** |
295 | | - * @brief Converts an entire string from one encoding to another, using iconv. Easier to use than iconv() itself, and supports autodetect encodings on input when extra features enabled. |
296 | | - * |
297 | | - * @note Converts a memory region given in encoding FROMCODE to a new memory |
298 | | - * region in encoding TOCODE. FROMCODE and TOCODE are as for iconv_open(3), |
299 | | - * except that FROMCODE may be one of the values when enabled extra features. |
300 | | - * |
301 | | - * @note "autodetect_utf8" supports ISO-8859-1 and UTF-8 |
302 | | - * @note "autodetect_jp" supports EUC-JP, ISO-2022-JP-2 and SHIFT_JIS |
303 | | - * @note "autodetect_kr" supports EUC-KR and ISO-2022-KR |
304 | | - * @note The input is in the memory region between start (inclusive) and end |
305 | | - * (exclusive). If resultp is not NULL, the output string is stored in |
306 | | - * *resultp; malloc/realloc is used to allocate the result. |
307 | | - * |
308 | | - * @note This function does not treat zero characters specially. |
309 | | - * |
310 | | - * @param tocode Target encoding. |
311 | | - * @param fromcode From encoding. |
312 | | - * @param start Source string start pointer. |
313 | | - * @param end Source string end pointer. |
314 | | - * @param resultp Result memory pointer. |
315 | | - * @param lengthp Pointer to a variable that stores the length of the result. |
316 | | - * @return Return 0 if successful, otherwise -1 and errno set. Particular errno values: EILSEQ and ENOMEM. |
317 | | - * |
318 | | - * @example |
319 | | - * const char* s = ...; |
320 | | - * char* result = NULL; |
321 | | - * if (iconv_string("UCS-4-INTERNAL", "GBK", |
322 | | - * s, s+strlen(s)+1, &result, NULL) < 0) |
323 | | - * perror("iconv_string"); |
324 | | - * |
325 | | - */ |
326 | | -''' |
327 | | - |
328 | | -''' |
329 | | - /** |
330 | | - * @brief Encode source string to another encoding. |
331 | | - * @param from From encoding. |
332 | | - * @param to Target encoding. |
333 | | - * @param data Input string data. |
334 | | - * @param ignore Ignore invalid characters. |
335 | | - * @throw int: when conversation error, throw the 'errno', you can catch the errno for more infomation. |
336 | | - */ |
337 | | -''' |
338 | | - /** |
339 | | - * @brief Encode source string to another encoding. |
340 | | - * @param from From encoding. |
341 | | - * @param to Target encoding. |
342 | | - * @param data Input string data. |
343 | | - * @param ignore Ignore invalid characters. |
344 | | - * @throw int: when conversation error, throw the 'errno', you can catch the errno for more infomation. |
345 | | - */ |
346 | | -''' |
| 4 | +# Original comment of reiconv.hpp.in is en_US, so we can keep this langmap empty. |
0 commit comments