# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2013-03-26 16:48+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: build/C/man3/iconv.3:18 #, no-wrap msgid "ICONV" msgstr "" #. type: TH #: build/C/man3/iconv.3:18 #, no-wrap msgid "2012-05-10" msgstr "" #. type: TH #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18 #, no-wrap msgid "GNU" msgstr "" #. type: TH #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:21 msgid "iconv - perform character set conversion" msgstr "" #. type: SH #: build/C/man3/iconv.3:21 build/C/man3/iconv_close.3:17 build/C/man3/iconv_open.3:21 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:24 build/C/man3/iconv_close.3:20 build/C/man3/iconv_open.3:24 #, no-wrap msgid "B<#include Eiconv.hE>\n" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:28 #, no-wrap msgid "" "BIB<,>\n" "B< char **>IB<, size_t *>IB<,>\n" "B< char **>IB<, size_t *>IB<);>\n" msgstr "" #. type: SH #: build/C/man3/iconv.3:29 build/C/man3/iconv_close.3:23 build/C/man3/iconv_open.3:27 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:54 msgid "" "The B() function converts a sequence of characters in one character " "encoding to a sequence of characters in another character encoding. The " "I argument is a conversion descriptor, previously created by a call to " "B(3); the conversion descriptor defines the character encodings " "that B() uses for the conversion. The I argument is the " "address of a variable that points to the first character of the input " "sequence; I indicates the number of bytes in that buffer. The " "I argument is the address of a variable that points to the first " "byte available in the output buffer; I indicates the number of " "bytes available in the output buffer." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:62 msgid "" "The main case is when I is not NULL and I<*inbuf> is not NULL. In " "this case, the B() function converts the multibyte sequence starting " "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>. At most " "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read. At most " "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:76 msgid "" "The B() function converts one multibyte character at a time, and for " "each character conversion it increments I<*inbuf> and decrements " "I<*inbytesleft> by the number of converted input bytes, it increments " "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output " "bytes, and it updates the conversion state contained in I. If the " "character encoding of the input is stateful, the B() function can " "also convert a sequence of input bytes to an update to the conversion state " "without producing any output bytes; such input is called a I. The conversion can stop for four reasons:" msgstr "" #. type: IP #: build/C/man3/iconv.3:76 #, no-wrap msgid "1." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:83 msgid "" "An invalid multibyte sequence is encountered in the input. In this case it " "sets I to B and returns I<(size_t)\\ -1>. I<*inbuf> is left " "pointing to the beginning of the invalid multibyte sequence." msgstr "" #. type: IP #: build/C/man3/iconv.3:83 #, no-wrap msgid "2." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:90 msgid "" "The input byte sequence has been entirely converted, that is, " "I<*inbytesleft> has gone down to 0. In this case B() returns the " "number of nonreversible conversions performed during this call." msgstr "" #. type: IP #: build/C/man3/iconv.3:90 #, no-wrap msgid "3." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:98 msgid "" "An incomplete multibyte sequence is encountered in the input, and the input " "byte sequence terminates after it. In this case it sets I to " "B and returns I<(size_t)\\ -1>. I<*inbuf> is left pointing to the " "beginning of the incomplete multibyte sequence." msgstr "" #. type: IP #: build/C/man3/iconv.3:98 #, no-wrap msgid "4." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:102 msgid "" "The output buffer has no more room for the next converted character. In " "this case it sets I to B and returns I<(size_t)\\ -1>." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:116 msgid "" "A different case is when I is NULL or I<*inbuf> is NULL, but " "I is not NULL and I<*outbuf> is not NULL. In this case, the " "B() function attempts to set I's conversion state to the initial " "state and store a corresponding shift sequence at I<*outbuf>. At most " "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written. If the " "output buffer has no more room for this reset sequence, it sets I to " "B and returns I<(size_t)\\ -1>. Otherwise it increments I<*outbuf> " "and decrements I<*outbytesleft> by the number of bytes written." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:122 msgid "" "A third case is when I is NULL or I<*inbuf> is NULL, and I is " "NULL or I<*outbuf> is NULL. In this case, the B() function sets " "I's conversion state to the initial state." msgstr "" #. type: SH #: build/C/man3/iconv.3:122 build/C/man3/iconv_close.3:29 build/C/man3/iconv_open.3:71 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:129 msgid "" "The B() function returns the number of characters converted in a " "nonreversible way during this call; reversible conversions are not counted. " "In case of error, it sets I and returns I<(size_t)\\ -1>." msgstr "" #. type: SH #: build/C/man3/iconv.3:129 build/C/man3/iconv_open.3:78 #, no-wrap msgid "ERRORS" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:131 msgid "The following errors can occur, among others:" msgstr "" #. type: TP #: build/C/man3/iconv.3:131 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:134 msgid "There is not sufficient room at I<*outbuf>." msgstr "" #. type: TP #: build/C/man3/iconv.3:134 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:137 msgid "An invalid multibyte sequence has been encountered in the input." msgstr "" #. type: TP #: build/C/man3/iconv.3:137 build/C/man3/iconv_open.3:80 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:140 msgid "An incomplete multibyte sequence has been encountered in the input." msgstr "" #. type: SH #: build/C/man3/iconv.3:140 build/C/man3/iconv_close.3:36 build/C/man3/iconv_open.3:84 #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86 msgid "This function is available in glibc since version 2.1." msgstr "" #. type: SH #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:144 msgid "POSIX.1-2001." msgstr "" #. type: SH #: build/C/man3/iconv.3:144 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:156 msgid "" "Although I and I are typed as I, this does not " "mean that the objects they point can be interpreted as C strings or as " "arrays of characters: the interpretation of character byte sequences is " "handled internally by the conversion functions. In some encodings, a zero " "byte may be a valid part of a multibyte character." msgstr "" #. type: Plain text #: build/C/man3/iconv.3:163 msgid "" "The caller of B() must ensure that the pointers passed to the " "function are suitable for accessing characters in the appropriate character " "set. This includes ensuring correct alignment on platforms that have tight " "restrictions on alignment." msgstr "" #. type: SH #: build/C/man3/iconv.3:163 build/C/man3/iconv_close.3:40 build/C/man3/iconv_open.3:88 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:166 msgid "B(3), B(3)" msgstr "" #. type: SH #: build/C/man3/iconv.3:166 build/C/man3/iconv_close.3:43 build/C/man3/iconv_open.3:92 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: build/C/man3/iconv.3:173 build/C/man3/iconv_close.3:50 build/C/man3/iconv_open.3:99 msgid "" "This page is part of release 3.50 of the Linux I project. A " "description of the project, and information about reporting bugs, can be " "found at http://www.kernel.org/doc/man-pages/." msgstr "" #. type: TH #: build/C/man3/iconv_close.3:14 #, no-wrap msgid "ICONV_CLOSE" msgstr "" #. type: TH #: build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18 #, no-wrap msgid "2008-08-11" msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:17 msgid "iconv_close - deallocate descriptor for character set conversion" msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:22 #, no-wrap msgid "BIB<);>\n" msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:29 msgid "" "The B() function deallocates a conversion descriptor I " "previously allocated using B(3)." msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:36 msgid "" "When successful, the B() function returns 0. In case of " "error, it sets I and returns -1." msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:40 build/C/man3/iconv_open.3:88 msgid "UNIX98, POSIX.1-2001." msgstr "" #. type: Plain text #: build/C/man3/iconv_close.3:43 msgid "B(3), B(3)" msgstr "" #. type: TH #: build/C/man3/iconv_open.3:18 #, no-wrap msgid "ICONV_OPEN" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:21 msgid "iconv_open - allocate descriptor for character set conversion" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:26 #, no-wrap msgid "" "BIB<, const char " "*>IB<);>\n" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:33 msgid "" "The B() function allocates a conversion descriptor suitable for " "converting byte sequences from character encoding I to character " "encoding I." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:41 msgid "" "The values permitted for I and I and the supported " "combinations are system-dependent. For the GNU C library, the permitted " "values are listed by the B command, and all combinations of " "the listed values are supported. Furthermore the GNU C library and the GNU " "libiconv library support the following two suffixes:" msgstr "" #. type: TP #: build/C/man3/iconv_open.3:41 #, no-wrap msgid "//TRANSLIT" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:48 msgid "" "When the string \"//TRANSLIT\" is appended to I, transliteration is " "activated. This means that when a character cannot be represented in the " "target character set, it can be approximated through one or several " "similarly looking characters." msgstr "" #. type: TP #: build/C/man3/iconv_open.3:48 #, no-wrap msgid "//IGNORE" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:52 msgid "" "When the string \"//IGNORE\" is appended to I, characters that " "cannot be represented in the target character set will be silently " "discarded." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:58 msgid "" "The resulting conversion descriptor can be used with B(3) any number " "of times. It remains valid until deallocated using B(3)." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:71 msgid "" "A conversion descriptor contains a conversion state. After creation using " "B(), the state is in the initial state. Using B(3) " "modifies the descriptor's conversion state. (This implies that a conversion " "descriptor can not be used in multiple threads simultaneously.) To bring " "the state back to the initial state, use B(3) with NULL as I " "argument." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:78 msgid "" "The B() function returns a freshly allocated conversion " "descriptor. In case of error, it sets I and returns I<(iconv_t)\\ " "-1>." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:80 msgid "The following error can occur, among others:" msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:84 msgid "" "The conversion from I to I is not supported by the " "implementation." msgstr "" #. type: Plain text #: build/C/man3/iconv_open.3:92 msgid "B(1), B(3), B(3)" msgstr ""