summaryrefslogtreecommitdiffstats
path: root/templates/man3/iconv.3.pot
diff options
context:
space:
mode:
Diffstat (limited to 'templates/man3/iconv.3.pot')
-rw-r--r--templates/man3/iconv.3.pot510
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 ""