diff options
Diffstat (limited to 'templates/man3/iconv.3.pot')
-rw-r--r-- | templates/man3/iconv.3.pot | 510 |
1 files changed, 510 insertions, 0 deletions
diff --git a/templates/man3/iconv.3.pot b/templates/man3/iconv.3.pot new file mode 100644 index 00000000..95b4d725 --- /dev/null +++ b/templates/man3/iconv.3.pot @@ -0,0 +1,510 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 16:58+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "iconv" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "iconv - perform character set conversion" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>iconv.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<size_t iconv(iconv_t >I<cd>B<,>\n" +"B< char **restrict >I<inbuf>B<, size_t *restrict >I<inbytesleft>B<,>\n" +"B< char **restrict >I<outbuf>B<, size_t *restrict >I<outbytesleft>B<);>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<iconv>() function converts a sequence of characters in one character " +"encoding to a sequence of characters in another character encoding. The " +"I<cd> argument is a conversion descriptor, previously created by a call to " +"B<iconv_open>(3); the conversion descriptor defines the character encodings " +"that B<iconv>() uses for the conversion. The I<inbuf> argument is the " +"address of a variable that points to the first character of the input " +"sequence; I<inbytesleft> indicates the number of bytes in that buffer. The " +"I<outbuf> argument is the address of a variable that points to the first " +"byte available in the output buffer; I<outbytesleft> indicates the number of " +"bytes available in the output buffer." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL. In " +"this case, the B<iconv>() 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 +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +msgid "" +"The B<iconv>() 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<cd>. If the " +"character encoding of the input is stateful, the B<iconv>() 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<shift " +"sequence>. The conversion can stop for five reasons:" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"An invalid multibyte sequence is encountered in the input. In this case, it " +"sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>. I<*inbuf> is left " +"pointing to the beginning of the invalid multibyte sequence." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +msgid "" +"A multibyte sequence is encountered that is valid but that cannot be " +"translated to the character encoding of the output. This condition depends " +"on the implementation and on the conversion descriptor. In the GNU C " +"library and GNU libiconv, if I<cd> was created without the suffix B<//" +"TRANSLIT> or B<//IGNORE>, the conversion is strict: lossy conversions " +"produce this condition. If the suffix B<//TRANSLIT> was specified, " +"transliteration can avoid this condition in some cases. In the musl C " +"library, this condition cannot occur because a conversion to " +"B<\\[aq]*\\[aq]> is used as a fallback. In the FreeBSD, NetBSD, and Solaris " +"implementations of B<iconv>(), this condition cannot occur either, because a " +"conversion to B<\\[aq]?\\[aq]> is used as a fallback. When this condition " +"is met, B<iconv>() sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ " +"-1>. I<*inbuf> is left pointing to the beginning of the unconvertible " +"multibyte sequence." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The input byte sequence has been entirely converted, that is, " +"I<*inbytesleft> has gone down to 0. In this case, B<iconv>() returns the " +"number of nonreversible conversions performed during this call." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"An incomplete multibyte sequence is encountered in the input, and the input " +"byte sequence terminates after it. In this case, it sets I<errno> to " +"B<EINVAL> and returns I<(size_t)\\ -1>. I<*inbuf> is left pointing to the " +"beginning of the incomplete multibyte sequence." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The output buffer has no more room for the next converted character. In " +"this case, it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but " +"I<outbuf> is not NULL and I<*outbuf> is not NULL. In this case, the " +"B<iconv>() function attempts to set I<cd>'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<errno> to " +"B<E2BIG> 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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is " +"NULL or I<*outbuf> is NULL. In this case, the B<iconv>() function sets " +"I<cd>'s conversion state to the initial state." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RETURN VALUE" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<iconv>() function returns the number of characters converted in a " +"nonreversible way during this call; reversible conversions are not counted. " +"In case of error, B<iconv>() returns I<(size_t)\\ -1> and sets I<errno> to " +"indicate the error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The following errors can occur, among others:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<E2BIG>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "There is not sufficient room at I<*outbuf>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EILSEQ>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "An invalid multibyte sequence has been encountered in the input." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "An incomplete multibyte sequence has been encountered in the input." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ATTRIBUTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For an explanation of the terms used in this section, see B<attributes>(7)." +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Interface" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Attribute" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Value" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".na\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".nh\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<iconv>()" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Thread safety" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "MT-Safe race:cd" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<iconv>() function is MT-Safe, as long as callers arrange for mutual " +"exclusion on the I<cd> argument." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "POSIX.1-2008." +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "HISTORY" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "glibc 2.1. POSIX.1-2001." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In each series of calls to B<iconv>(), the last should be one with I<inbuf> " +"or I<*inbuf> equal to NULL, in order to flush out any partially converted " +"input." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Although I<inbuf> and I<outbuf> are typed as I<char\\ **>, 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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The caller of B<iconv>() 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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<iconv_close>(3), B<iconv_open>(3), B<iconvconfig>(8)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The B<iconv>() 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<cd>. If the " +"character encoding of the input is stateful, the B<iconv>() 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<shift " +"sequence>. The conversion can stop for four reasons:" +msgstr "" + +#. type: SH +#: debian-bookworm +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "This function is available since glibc 2.1." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "POSIX.1-2001, POSIX.1-2008." +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-07-20" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |