1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2015-01-23 22:24+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man3/iconv.3:18
26 #: build/C/man3/iconv.3:18
32 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
38 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
40 msgid "Linux Programmer's Manual"
44 #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19
50 #: build/C/man3/iconv.3:21
51 msgid "iconv - perform character set conversion"
55 #: build/C/man3/iconv.3:21 build/C/man3/iconv_close.3:17 build/C/man3/iconv_open.3:21
61 #: build/C/man3/iconv.3:24 build/C/man3/iconv_close.3:20 build/C/man3/iconv_open.3:24
63 msgid "B<#include E<lt>iconv.hE<gt>>\n"
67 #: build/C/man3/iconv.3:28
70 "B<size_t iconv(iconv_t >I<cd>B<,>\n"
71 "B< char **>I<inbuf>B<, size_t *>I<inbytesleft>B<,>\n"
72 "B< char **>I<outbuf>B<, size_t *>I<outbytesleft>B<);>\n"
76 #: build/C/man3/iconv.3:29 build/C/man3/iconv_close.3:23 build/C/man3/iconv_open.3:27
82 #: build/C/man3/iconv.3:54
84 "The B<iconv>() function converts a sequence of characters in one character "
85 "encoding to a sequence of characters in another character encoding. The "
86 "I<cd> argument is a conversion descriptor, previously created by a call to "
87 "B<iconv_open>(3); the conversion descriptor defines the character encodings "
88 "that B<iconv>() uses for the conversion. The I<inbuf> argument is the "
89 "address of a variable that points to the first character of the input "
90 "sequence; I<inbytesleft> indicates the number of bytes in that buffer. The "
91 "I<outbuf> argument is the address of a variable that points to the first "
92 "byte available in the output buffer; I<outbytesleft> indicates the number of "
93 "bytes available in the output buffer."
97 #: build/C/man3/iconv.3:62
99 "The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL. In "
100 "this case, the B<iconv>() function converts the multibyte sequence starting "
101 "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>. At most "
102 "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read. At most "
103 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written."
107 #: build/C/man3/iconv.3:76
109 "The B<iconv>() function converts one multibyte character at a time, and for "
110 "each character conversion it increments I<*inbuf> and decrements "
111 "I<*inbytesleft> by the number of converted input bytes, it increments "
112 "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output "
113 "bytes, and it updates the conversion state contained in I<cd>. If the "
114 "character encoding of the input is stateful, the B<iconv>() function can "
115 "also convert a sequence of input bytes to an update to the conversion state "
116 "without producing any output bytes; such input is called a I<shift "
117 "sequence>. The conversion can stop for four reasons:"
121 #: build/C/man3/iconv.3:76
127 #: build/C/man3/iconv.3:83
129 "An invalid multibyte sequence is encountered in the input. In this case, it "
130 "sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>. I<*inbuf> is left "
131 "pointing to the beginning of the invalid multibyte sequence."
135 #: build/C/man3/iconv.3:83
141 #: build/C/man3/iconv.3:90
143 "The input byte sequence has been entirely converted, that is, "
144 "I<*inbytesleft> has gone down to 0. In this case, B<iconv>() returns the "
145 "number of nonreversible conversions performed during this call."
149 #: build/C/man3/iconv.3:90
155 #: build/C/man3/iconv.3:98
157 "An incomplete multibyte sequence is encountered in the input, and the input "
158 "byte sequence terminates after it. In this case, it sets I<errno> to "
159 "B<EINVAL> and returns I<(size_t)\\ -1>. I<*inbuf> is left pointing to the "
160 "beginning of the incomplete multibyte sequence."
164 #: build/C/man3/iconv.3:98
170 #: build/C/man3/iconv.3:102
172 "The output buffer has no more room for the next converted character. In "
173 "this case, it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>."
177 #: build/C/man3/iconv.3:116
179 "A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but "
180 "I<outbuf> is not NULL and I<*outbuf> is not NULL. In this case, the "
181 "B<iconv>() function attempts to set I<cd>'s conversion state to the initial "
182 "state and store a corresponding shift sequence at I<*outbuf>. At most "
183 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written. If the "
184 "output buffer has no more room for this reset sequence, it sets I<errno> to "
185 "B<E2BIG> and returns I<(size_t)\\ -1>. Otherwise, it increments I<*outbuf> "
186 "and decrements I<*outbytesleft> by the number of bytes written."
190 #: build/C/man3/iconv.3:122
192 "A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is "
193 "NULL or I<*outbuf> is NULL. In this case, the B<iconv>() function sets "
194 "I<cd>'s conversion state to the initial state."
198 #: build/C/man3/iconv.3:122 build/C/man3/iconv_close.3:30 build/C/man3/iconv_open.3:86
204 #: build/C/man3/iconv.3:129
206 "The B<iconv>() function returns the number of characters converted in a "
207 "nonreversible way during this call; reversible conversions are not counted. "
208 "In case of error, it sets I<errno> and returns I<(size_t)\\ -1>."
212 #: build/C/man3/iconv.3:129 build/C/man3/iconv_open.3:95
218 #: build/C/man3/iconv.3:131
219 msgid "The following errors can occur, among others:"
223 #: build/C/man3/iconv.3:131
229 #: build/C/man3/iconv.3:134
230 msgid "There is not sufficient room at I<*outbuf>."
234 #: build/C/man3/iconv.3:134
240 #: build/C/man3/iconv.3:137
241 msgid "An invalid multibyte sequence has been encountered in the input."
245 #: build/C/man3/iconv.3:137 build/C/man3/iconv_open.3:97
251 #: build/C/man3/iconv.3:140
252 msgid "An incomplete multibyte sequence has been encountered in the input."
256 #: build/C/man3/iconv.3:140 build/C/man3/iconv_close.3:37 build/C/man3/iconv_open.3:105
262 #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
263 msgid "This function is available in glibc since version 2.1."
267 #: build/C/man3/iconv.3:142
273 #: build/C/man3/iconv.3:143
275 msgid "Multithreading (see pthreads(7))"
279 #: build/C/man3/iconv.3:147
280 msgid "The B<iconv>() function is thread-safe."
284 #: build/C/man3/iconv.3:147 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
286 msgid "CONFORMING TO"
290 #: build/C/man3/iconv.3:149
291 msgid "POSIX.1-2001."
295 #: build/C/man3/iconv.3:149
301 #: build/C/man3/iconv.3:161
303 "Although I<inbuf> and I<outbuf> are typed as I<char\\ **>, this does not "
304 "mean that the objects they point can be interpreted as C strings or as "
305 "arrays of characters: the interpretation of character byte sequences is "
306 "handled internally by the conversion functions. In some encodings, a zero "
307 "byte may be a valid part of a multibyte character."
311 #: build/C/man3/iconv.3:168
313 "The caller of B<iconv>() must ensure that the pointers passed to the "
314 "function are suitable for accessing characters in the appropriate character "
315 "set. This includes ensuring correct alignment on platforms that have tight "
316 "restrictions on alignment."
320 #: build/C/man3/iconv.3:168 build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
326 #: build/C/man3/iconv.3:172
327 msgid "B<iconv_close>(3), B<iconv_open>(3), B<iconvconfig>(8)"
331 #: build/C/man3/iconv.3:172 build/C/man3/iconv_close.3:44 build/C/man3/iconv_open.3:113
337 #: build/C/man3/iconv.3:180 build/C/man3/iconv_close.3:52 build/C/man3/iconv_open.3:121
339 "This page is part of release 3.78 of the Linux I<man-pages> project. A "
340 "description of the project, information about reporting bugs, and the latest "
341 "version of this page, can be found at "
342 "\\%http://www.kernel.org/doc/man-pages/."
346 #: build/C/man3/iconv_close.3:14
352 #: build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
358 #: build/C/man3/iconv_close.3:17
359 msgid "iconv_close - deallocate descriptor for character set conversion"
363 #: build/C/man3/iconv_close.3:22
365 msgid "B<int iconv_close(iconv_t >I<cd>B<);>\n"
369 #: build/C/man3/iconv_close.3:30
371 "The B<iconv_close>() function deallocates a conversion descriptor I<cd> "
372 "previously allocated using B<iconv_open>(3)."
376 #: build/C/man3/iconv_close.3:37
378 "When successful, the B<iconv_close>() function returns 0. In case of "
379 "error, it sets I<errno> and returns -1."
383 #: build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
384 msgid "UNIX98, POSIX.1-2001."
388 #: build/C/man3/iconv_close.3:44
389 msgid "B<iconv>(3), B<iconv_open>(3)"
393 #: build/C/man3/iconv_open.3:18
399 #: build/C/man3/iconv_open.3:21
400 msgid "iconv_open - allocate descriptor for character set conversion"
404 #: build/C/man3/iconv_open.3:26
407 "B<iconv_t iconv_open(const char *>I<tocode>B<, const char "
408 "*>I<fromcode>B<);>\n"
412 #: build/C/man3/iconv_open.3:36
414 "The B<iconv_open>() function allocates a conversion descriptor suitable for "
415 "converting byte sequences from character encoding I<fromcode> to character "
416 "encoding I<tocode>."
420 #: build/C/man3/iconv_open.3:50
422 "The values permitted for I<fromcode> and I<tocode> and the supported "
423 "combinations are system-dependent. For the GNU C library, the permitted "
424 "values are listed by the I<iconv --list> command, and all combinations of "
425 "the listed values are supported. Furthermore the GNU C library and the GNU "
426 "libiconv library support the following two suffixes:"
430 #: build/C/man3/iconv_open.3:50
436 #: build/C/man3/iconv_open.3:59
438 "When the string \"//TRANSLIT\" is appended to I<tocode>, transliteration is "
439 "activated. This means that when a character cannot be represented in the "
440 "target character set, it can be approximated through one or several "
441 "similarly looking characters."
445 #: build/C/man3/iconv_open.3:59
451 #: build/C/man3/iconv_open.3:65
453 "When the string \"//IGNORE\" is appended to I<tocode>, characters that "
454 "cannot be represented in the target character set will be silently "
459 #: build/C/man3/iconv_open.3:71
461 "The resulting conversion descriptor can be used with B<iconv>(3) any number "
462 "of times. It remains valid until deallocated using B<iconv_close>(3)."
466 #: build/C/man3/iconv_open.3:86
468 "A conversion descriptor contains a conversion state. After creation using "
469 "B<iconv_open>(), the state is in the initial state. Using B<iconv>(3) "
470 "modifies the descriptor's conversion state. (This implies that a conversion "
471 "descriptor can not be used in multiple threads simultaneously.) To bring "
472 "the state back to the initial state, use B<iconv>(3) with NULL as I<inbuf> "
477 #: build/C/man3/iconv_open.3:95
479 "The B<iconv_open>() function returns a freshly allocated conversion "
480 "descriptor. In case of error, it sets I<errno> and returns I<(iconv_t)\\ "
485 #: build/C/man3/iconv_open.3:97
486 msgid "The following error can occur, among others:"
490 #: build/C/man3/iconv_open.3:105
492 "The conversion from I<fromcode> to I<tocode> is not supported by the "
497 #: build/C/man3/iconv_open.3:113
498 msgid "B<iconv>(1), B<iconv>(3), B<iconv_close>(3)"