@cpp.js/package-iconv 1.0.0-beta.20 → 1.0.0-beta.21

package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconvctl.3

@@ -9,7 +9,7 @@
 .\" References consulted:
 .\"   iconv.h
 .\"
-.TH ICONVCTL 3  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONVCTL 3  "December 15, 2024" "GNU"
 .SH NAME
 iconvctl \- control iconv behavior
 .SH SYNOPSIS
@@ -41,15 +41,60 @@ transliteration is enabled in the conversion, or 0 otherwise.
 A non-zero value is used to enable transliteration in the conversion. A zero
 value disables it.
 .TP
+.B ICONV_GET_DISCARD_INVALID
+\fIargument\fP should be an \fBint *\fP which will receive 1 if "discard
+invalid multibyte sequence from the input and continue"
+is enabled in the conversion, or 0 otherwise.
+.TP
+.B ICONV_SET_DISCARD_INVALID
+\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
+A non-zero value is used to enable "discard
+invalid multibyte sequence from the input and continue"
+in the conversion. A zero value disables it.
+.TP
+.B ICONV_GET_DISCARD_NON_IDENTICAL
+\fIargument\fP should be an \fBint *\fP which will receive 1 if "discard
+character that cannot be represented in the target character set and continue"
+is enabled in the conversion, or 0 otherwise.
+.TP
+.B ICONV_SET_DISCARD_NON_IDENTICAL
+\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
+A non-zero value is used to enable "discard
+character that cannot be represented in the target character set and continue"
+in the conversion. A zero value disables it.
+.TP
 .B ICONV_GET_DISCARD_ILSEQ
-\fIargument\fP should be an \fBint *\fP which will receive 1 if 
-"illegal sequence discard and continue" is enabled in the conversion,
-or 0 otherwise.
+\fIargument\fP should be an \fBint *\fP which will receive 1 if both "discard"
+behaviours are enabled in the conversion, or 0 otherwise.
 .TP
 .B ICONV_SET_DISCARD_ILSEQ
 \fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
-A non-zero value is used to enable "illegal sequence discard and continue"
-in the conversion. A zero value disables it.
+A non-zero value is used to enable both "discard" behaviours in the conversion.
+A zero value disables them.
+.TP
+.B ICONV_GET_FROM_SURFACE
+\fIargument\fP should be an \fBunsigned int *\fP which will receive the
+from-side (input side) surface of the conversion.
+.TP
+.B ICONV_SET_FROM_SURFACE
+\fIargument\fP should be a \fBconst unsigned int *\fP, pointing to an
+\fBunsigned int\fP value.  This value is installed as the from-side
+(input side) surface of the conversion.  The value is a bit mask.  Zero
+denotes no surface.  The value \fBICONV_SURFACE_EBCDIC_ZOS_UNIX\fP has
+an effect on EBCDIC encodings: The EBCDIC newline 0x15 will get mapped
+to LF instead of NEL.
+.TP
+.B ICONV_GET_TO_SURFACE
+\fIargument\fP should be an \fBunsigned int *\fP which will receive the
+to-side (output side) surface of the conversion.
+.TP
+.B ICONV_SET_TO_SURFACE
+\fIargument\fP should be a \fBconst unsigned int *\fP, pointing to an
+\fBunsigned int\fP value.  This value is installed as the to-side
+(output side) surface of the conversion.  The value is a bit mask.  Zero
+denotes no surface.  The value \fBICONV_SURFACE_EBCDIC_ZOS_UNIX\fP has
+an effect on EBCDIC encodings: LF, instead of NEL, will get mapped to
+the EBCDIC newline 0x15.
 .SH "RETURN VALUE"
 The \fBiconvctl\fP function returns 0 if it succeeds. In case of error, it sets
 \fBerrno\fP and returns \-1.

package/dist/prebuilt/iOS-iphonesimulator/include/iconv.h

@@ -1,4 +1,4 @@
-/* Copyright (C) 1999-2022 Free Software Foundation, Inc.
+/* Copyright (C) 1999-2024 Free Software Foundation, Inc.
    This file is part of the GNU LIBICONV Library.
 
    The GNU LIBICONV Library is free software; you can redistribute it
@@ -20,25 +20,28 @@
 #ifndef _LIBICONV_H
 #define _LIBICONV_H
 
-#define _LIBICONV_VERSION 0x0111    /* version number: (major<<8) + minor */
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define _LIBICONV_VERSION 0x0112    /* version number: (major<<8) + minor */
 extern  int _libiconv_version; /* Likewise */
 
+#ifdef __cplusplus
+}
+#endif
+
 /* We would like to #include any system header file which could define
-   iconv_t, 1. in order to eliminate the risk that the user gets compilation
+   iconv_t, in order to eliminate the risk that the user gets compilation
    errors because some other system header file includes /usr/include/iconv.h
-   which defines iconv_t or declares iconv after this file, 2. when compiling
-   for LIBICONV_PLUG, we need the proper iconv_t type in order to produce
-   binary compatible code.
+   which defines iconv_t or declares iconv after this file.
    But gcc's #include_next is not portable. Thus, once libiconv's iconv.h
    has been installed in /usr/local/include, there is no way any more to
    include the original /usr/include/iconv.h. We simply have to get away
    without it.
-   Ad 1. The risk that a system header file does
+   The risk that a system header file does
    #include "iconv.h"  or  #include_next "iconv.h"
-   is small. They all do #include <iconv.h>.
-   Ad 2. The iconv_t type is a pointer type in all cases I have seen. (It
-   has to be a scalar type because (iconv_t)(-1) is a possible return value
-   from iconv_open().) */
+   is small. They all do #include <iconv.h>. */
 
 /* Define iconv_t ourselves. */
 #undef iconv_t
@@ -66,9 +69,7 @@ extern "C" {
 
 /* Allocates descriptor for code conversion from encoding ‘fromcode’ to
    encoding ‘tocode’. */
-#ifndef LIBICONV_PLUG
 #define iconv_open libiconv_open
-#endif
 extern iconv_t iconv_open (const char* tocode, const char* fromcode);
 
 /* Converts, using conversion descriptor ‘cd’, at most ‘*inbytesleft’ bytes
@@ -76,15 +77,11 @@ extern iconv_t iconv_open (const char* tocode, const char* fromcode);
    ‘*outbuf’.
    Decrements ‘*inbytesleft’ and increments ‘*inbuf’ by the same amount.
    Decrements ‘*outbytesleft’ and increments ‘*outbuf’ by the same amount. */
-#ifndef LIBICONV_PLUG
 #define iconv libiconv
-#endif
 extern size_t iconv (iconv_t cd,  char* * inbuf, size_t *inbytesleft, char* * outbuf, size_t *outbytesleft);
 
 /* Frees resources allocated for conversion descriptor ‘cd’. */
-#ifndef LIBICONV_PLUG
 #define iconv_close libiconv_close
-#endif
 extern int iconv_close (iconv_t cd);
 
 
@@ -93,8 +90,6 @@ extern int iconv_close (iconv_t cd);
 #endif
 
 
-#ifndef LIBICONV_PLUG
-
 /* Nonstandard extensions. */
 
 #if 1
@@ -165,7 +160,6 @@ typedef void (*iconv_unicode_uc_to_mb_fallback)
                                          void* callback_arg),
               void* callback_arg,
               void* data);
-#if 1
 /* Fallback function.  Invoked when a number of bytes could not be converted to
    a wide character.  This function should process all bytes from inbuf and may
    produce replacement wide characters by calling the write_replacement
@@ -186,12 +180,6 @@ typedef void (*iconv_wchar_wc_to_mb_fallback)
                                          void* callback_arg),
               void* callback_arg,
               void* data);
-#else
-/* If the wchar_t type does not exist, these two fallback functions are never
-   invoked.  Their argument list therefore does not matter.  */
-typedef void (*iconv_wchar_mb_to_wc_fallback) ();
-typedef void (*iconv_wchar_wc_to_mb_fallback) ();
-#endif
 /* Set of fallbacks. */
 struct iconv_fallbacks {
   iconv_unicode_mb_to_uc_fallback mb_to_uc_fallback;
@@ -201,14 +189,30 @@ struct iconv_fallbacks {
   void* data;
 };
 
+/* Surfaces.
+   The concept of surfaces is described in the 'recode' manual.  */
+#define ICONV_SURFACE_NONE             0
+/* In EBCDIC encodings, 0x15 (which encodes the "newline function", see the
+   Unicode standard, chapter 5) maps to U+000A instead of U+0085.  This is
+   for interoperability with C programs and Unix environments on z/OS.  */
+#define ICONV_SURFACE_EBCDIC_ZOS_UNIX  1
+
 /* Requests for iconvctl. */
-#define ICONV_TRIVIALP            0  /* int *argument */
-#define ICONV_GET_TRANSLITERATE   1  /* int *argument */
-#define ICONV_SET_TRANSLITERATE   2  /* const int *argument */
-#define ICONV_GET_DISCARD_ILSEQ   3  /* int *argument */
-#define ICONV_SET_DISCARD_ILSEQ   4  /* const int *argument */
-#define ICONV_SET_HOOKS           5  /* const struct iconv_hooks *argument */
-#define ICONV_SET_FALLBACKS       6  /* const struct iconv_fallbacks *argument */
+#define ICONV_TRIVIALP                    0  /* int *argument */
+#define ICONV_GET_TRANSLITERATE           1  /* int *argument */
+#define ICONV_SET_TRANSLITERATE           2  /* const int *argument */
+#define ICONV_GET_DISCARD_ILSEQ           3  /* int *argument */
+#define ICONV_SET_DISCARD_ILSEQ           4  /* const int *argument */
+#define ICONV_SET_HOOKS                   5  /* const struct iconv_hooks *argument */
+#define ICONV_SET_FALLBACKS               6  /* const struct iconv_fallbacks *argument */
+#define ICONV_GET_FROM_SURFACE            7  /* unsigned int *argument */
+#define ICONV_SET_FROM_SURFACE            8  /* const unsigned int *argument */
+#define ICONV_GET_TO_SURFACE              9  /* unsigned int *argument */
+#define ICONV_SET_TO_SURFACE             10  /* const unsigned int *argument */
+#define ICONV_GET_DISCARD_INVALID        11  /* int *argument */
+#define ICONV_SET_DISCARD_INVALID        12  /* const int *argument */
+#define ICONV_GET_DISCARD_NON_IDENTICAL  13  /* int *argument */
+#define ICONV_SET_DISCARD_NON_IDENTICAL  14  /* const int *argument */
 
 /* Listing of locale independent encodings. */
 #define iconvlist libiconvlist
@@ -235,7 +239,5 @@ extern void libiconv_set_relocation_prefix (const char *orig_prefix,
 }
 #endif
 
-#endif
-
 
 #endif /* _LIBICONV_H */

package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.la

@@ -1,5 +1,5 @@
 # libcharset.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.7
+# Generated by libtool (GNU libtool) 2.5.4
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.

package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.la

@@ -1,5 +1,5 @@
 # libiconv.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.7
+# Generated by libtool (GNU libtool) 2.5.4
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -23,9 +23,9 @@ dependency_libs=''
 weak_library_names=''
 
 # Version information for libiconv.
-current=8
-age=6
-revision=1
+current=9
+age=7
+revision=0
 
 # Is this an already installed library?
 installed=yes

package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.1.html

@@ -22,6 +22,7 @@
 <a href="#NAME">NAME</a><br>
 <a href="#SYNOPSIS">SYNOPSIS</a><br>
 <a href="#DESCRIPTION">DESCRIPTION</a><br>
+<a href="#ENVIRONMENT">ENVIRONMENT</a><br>
 <a href="#EXAMPLES">EXAMPLES</a><br>
 <a href="#CONFORMING TO">CONFORMING TO</a><br>
 <a href="#SEE ALSO">SEE ALSO</a><br>
@@ -155,6 +156,17 @@ are printed in upper case, separated by whitespace, and
 alias names of an encoding are listed on the same line as
 the encoding itself.</p>
 
+<h2>ENVIRONMENT
+<a name="ENVIRONMENT"></a>
+</h2>
+
+
+<p style="margin-left:11%; margin-top: 1em">Conversion
+from/to EBCDIC encodings can be modified in a specific way:
+If the environment variable <b>ICONV_EBCDIC_ZOS_UNIX</b> is
+set to a non-empty value, the EBCDIC newline 0x15 will get
+mapped to LF instead of NEL.</p>
+
 <h2>EXAMPLES
 <a name="EXAMPLES"></a>
 </h2>
@@ -190,7 +202,7 @@ encodings.</p>
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>

package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.3.html

@@ -25,6 +25,7 @@
 <a href="#RETURN VALUE">RETURN VALUE</a><br>
 <a href="#ERRORS">ERRORS</a><br>
 <a href="#CONFORMING TO">CONFORMING TO</a><br>
+<a href="#NOTES">NOTES</a><br>
 <a href="#SEE ALSO">SEE ALSO</a><br>
 
 <hr>
@@ -83,7 +84,7 @@ encoding of the input is stateful, the <b>iconv</b> function
 can also convert a sequence of input bytes to an update of
 the conversion state without producing any output bytes;
 such input is called a <i>shift sequence</i>. The conversion
-can stop for four reasons:</p>
+can stop for five reasons:</p>
 
 <p style="margin-left:11%; margin-top: 1em">1. An invalid
 multibyte sequence is encountered in the input. In this case
@@ -91,20 +92,40 @@ it sets <b>errno</b> to <b>EILSEQ</b> and returns
 (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
 beginning of the invalid multibyte sequence.</p>
 
-<p style="margin-left:11%; margin-top: 1em">2. The input
+<p style="margin-left:11%; margin-top: 1em">2. 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</i> was created without the suffix
+<b>//TRANSLIT</b> or <b>//IGNORE</b> or
+<b>//NON_IDENTICAL_DISCARD</b>, the conversion is strict:
+lossy conversions produce this condition. If the suffix
+<b>//TRANSLIT</b> was specified, transliteration can avoid
+this condition in some cases. In the musl C library, this
+condition cannot occur because a conversion to <b>'*'</b> is
+used as a fallback. In the FreeBSD, NetBSD, and Solaris
+implementations of <b>iconv</b>, this condition cannot occur
+either, because a conversion to <b>'?'</b> is used as a
+fallback. When this condition is met, the <b>iconv</b>
+function sets <b>errno</b> to <b>EILSEQ</b> and returns
+(size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
+beginning of the unconvertible multibyte sequence.</p>
+
+<p style="margin-left:11%; margin-top: 1em">3. The input
 byte sequence has been entirely converted, i.e.
 <i>*inbytesleft</i> has gone down to 0. In this case
 <b>iconv</b> returns the number of non-reversible
 conversions performed during this call.</p>
 
-<p style="margin-left:11%; margin-top: 1em">3. An
+<p style="margin-left:11%; margin-top: 1em">4. An
 incomplete multibyte sequence is encountered in the input,
 and the input byte sequence terminates after it. In this
 case it sets <b>errno</b> to <b>EINVAL</b> and returns
 (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
 beginning of the incomplete multibyte sequence.</p>
 
-<p style="margin-left:11%; margin-top: 1em">4. The output
+<p style="margin-left:11%; margin-top: 1em">5. The output
 buffer has no more room for the next converted character. In
 this case it sets <b>errno</b> to <b>E2BIG</b> and returns
 (size_t)(&minus;1).</p>
@@ -191,7 +212,35 @@ the input.</p></td></tr>
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
+
+<h2>NOTES
+<a name="NOTES"></a>
+</h2>
+
+
+<p style="margin-left:11%; margin-top: 1em">In each series
+of calls to the <b>iconv</b> function, the last should be
+one with <i>inbuf</i> or <i>*inbuf</i> equal to NULL, in
+order to complete the conversion of any partially converted
+input.</p>
+
+<p style="margin-left:11%; margin-top: 1em">Although
+<i>inbuf</i> and <i>outbuf</i> are typed as <b>const char
+**</b> and <b>char **</b>, respectively, 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.</p>
+
+<p style="margin-left:11%; margin-top: 1em">The caller of
+the <b>iconv</b> function must ensure that the pointers
+passed to the function are suitable for accessing characters
+in the appropriate character set. For the encodings
+<b>UCS-2-INTERNAL</b>, <b>UCS-4-INTERNAL</b>, and
+<b>wchar_t</b>, this includes ensuring correct
+alignment.</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>
@@ -200,7 +249,7 @@ the input.</p></td></tr>
 
 
 <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3),
-<b>iconvctl</b>(3) <b>iconv_close</b>(3)</p>
+<b>iconvctl</b>(3), <b>iconv_close</b>(3)</p>
 <hr>
 </body>
 </html>

package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_close.3.html

@@ -74,7 +74,7 @@ case of error, it sets <b>errno</b> and returns
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>

package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open.3.html

@@ -90,9 +90,10 @@ ISO-2022&minus;JP&minus;MS</p>
 <p style="margin-left:11%;">Chinese</p>
 
 <p style="margin-left:22%;">EUC&minus;CN, HZ, GBK, CP936,
-GB18030, EUC&minus;TW, BIG5, CP950, BIG5&minus;HKSCS,
-BIG5&minus;HKSCS:2004, BIG5&minus;HKSCS:2001,
-BIG5&minus;HKSCS:1999, ISO&minus;2022&minus;CN,
+GB18030, GB18030:2022, EUC&minus;TW, BIG5, CP950,
+BIG5&minus;HKSCS, BIG5&minus;HKSCS:2004,
+BIG5&minus;HKSCS:2001, BIG5&minus;HKSCS:1999,
+ISO&minus;2022&minus;CN,
 ISO&minus;2022&minus;CN&minus;EXT</p>
 
 <table width="100%" border="0" rules="none" frame="void"
@@ -273,9 +274,15 @@ it can be approximated through one or several characters
 that look similar to the original character.</p>
 
 <p style="margin-left:11%; margin-top: 1em">When the string
-&quot;//IGNORE&quot; is appended to <i>tocode</i>,
-characters that cannot be represented in the target
-character set will be silently discarded.</p>
+&quot;//IGNORE&quot; is appended to <i>tocode</i>, invalid
+multibyte sequences in the input and characters that cannot
+be represented in the target character set will be silently
+discarded.</p>
+
+<p style="margin-left:11%; margin-top: 1em">When the string
+&quot;//NON_IDENTICAL_DISCARD&quot; is appended to
+<i>tocode</i>, characters that cannot be represented in the
+target character set will be silently discarded.</p>
 
 <p style="margin-left:11%; margin-top: 1em">The resulting
 conversion descriptor can be used with <b>iconv</b> any
@@ -330,7 +337,7 @@ not supported by the implementation.</p></td></tr>
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>

package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconvctl.3.html

@@ -96,21 +96,95 @@ non-zero value is used to enable transliteration in the
 conversion. A zero value disables it.</p>
 
 
+<p style="margin-left:11%;"><b>ICONV_GET_DISCARD_INVALID</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>int *</b> which will receive 1 if &quot;discard invalid
+multibyte sequence from the input and continue&quot; is
+enabled in the conversion, or 0 otherwise.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_DISCARD_INVALID</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const int *</b>, pointing to an <b>int</b> value. A
+non-zero value is used to enable &quot;discard invalid
+multibyte sequence from the input and continue&quot; in the
+conversion. A zero value disables it.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_DISCARD_NON_IDENTICAL</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>int *</b> which will receive 1 if &quot;discard character
+that cannot be represented in the target character set and
+continue&quot; is enabled in the conversion, or 0
+otherwise.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_DISCARD_NON_IDENTICAL</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const int *</b>, pointing to an <b>int</b> value. A
+non-zero value is used to enable &quot;discard character
+that cannot be represented in the target character set and
+continue&quot; in the conversion. A zero value disables
+it.</p>
+
+
 <p style="margin-left:11%;"><b>ICONV_GET_DISCARD_ILSEQ</b></p>
 
 <p style="margin-left:22%;"><i>argument</i> should be an
-<b>int *</b> which will receive 1 if &quot;illegal sequence
-discard and continue&quot; is enabled in the conversion, or
-0 otherwise.</p>
+<b>int *</b> which will receive 1 if both
+&quot;discard&quot; behaviours are enabled in the
+conversion, or 0 otherwise.</p>
 
 
 <p style="margin-left:11%;"><b>ICONV_SET_DISCARD_ILSEQ</b></p>
 
 <p style="margin-left:22%;"><i>argument</i> should be a
 <b>const int *</b>, pointing to an <b>int</b> value. A
-non-zero value is used to enable &quot;illegal sequence
-discard and continue&quot; in the conversion. A zero value
-disables it.</p>
+non-zero value is used to enable both &quot;discard&quot;
+behaviours in the conversion. A zero value disables
+them.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_FROM_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>unsigned int *</b> which will receive the from-side
+(input side) surface of the conversion.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_FROM_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const unsigned int *</b>, pointing to an <b>unsigned
+int</b> value. This value is installed as the from-side
+(input side) surface of the conversion. The value is a bit
+mask. Zero denotes no surface. The value
+<b>ICONV_SURFACE_EBCDIC_ZOS_UNIX</b> has an effect on EBCDIC
+encodings: The EBCDIC newline 0x15 will get mapped to LF
+instead of NEL.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_TO_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>unsigned int *</b> which will receive the to-side (output
+side) surface of the conversion.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_TO_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const unsigned int *</b>, pointing to an <b>unsigned
+int</b> value. This value is installed as the to-side
+(output side) surface of the conversion. The value is a bit
+mask. Zero denotes no surface. The value
+<b>ICONV_SURFACE_EBCDIC_ZOS_UNIX</b> has an effect on EBCDIC
+encodings: LF, instead of NEL, will get mapped to the EBCDIC
+newline 0x15.</p>
 
 <h2>RETURN VALUE
 <a name="RETURN VALUE"></a>

package/dist/prebuilt/iOS-iphonesimulator/share/man/man1/iconv.1

@@ -9,7 +9,7 @@
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"   POSIX 2001 draft6
 .\"
-.TH ICONV 1  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONV 1  "December 15, 2024" "GNU"
 .SH NAME
 iconv \- character set conversion
 .SH SYNOPSIS
@@ -84,6 +84,10 @@ supported encodings, in a system dependent format. For the libiconv
 implementation, the names are printed in upper case, separated by whitespace,
 and alias names of an encoding are listed on the same line as the encoding
 itself.
+.SH ENVIRONMENT
+Conversion from/to EBCDIC encodings can be modified in a specific way:
+If the environment variable \fBICONV_EBCDIC_ZOS_UNIX\fP is set to a non-empty
+value, the EBCDIC newline 0x15 will get mapped to LF instead of NEL.
 .SH EXAMPLES
 .TP
 \fBiconv \-f ISO\-8859\-1 \-t UTF\-8\fP
@@ -102,7 +106,7 @@ bytes and for valid but unconvertible characters.
 \fBiconv \-\-list\fP
 lists the supported encodings.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
 .SH "SEE ALSO"
 .BR iconv_open (3),
 .BR locale (7)

package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv.3

@@ -9,7 +9,7 @@
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"
-.TH ICONV 3  "September 7, 2008" "GNU" "Linux Programmer's Manual"
+.TH ICONV 3  "December 15, 2024" "GNU"
 .SH NAME
 iconv \- perform character set conversion
 .SH SYNOPSIS
@@ -38,22 +38,41 @@ output bytes, and it updates the conversion state contained in \fIcd\fP.
 If the character encoding of the input is stateful, the \fBiconv\fP function
 can also convert a sequence of input bytes to an update of the conversion state
 without producing any output bytes; such input is called a \fIshift sequence\fP.
-The conversion can stop for four reasons:
+The conversion can stop for five reasons:
 .PP
 1. An invalid multibyte sequence is encountered in the input. In this case
 it sets \fBerrno\fP to \fBEILSEQ\fP and returns (size_t)(\-1). \fI*inbuf\fP
 is left pointing to the beginning of the invalid multibyte sequence.
 .PP
-2. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
+2. 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 \fIcd\fP was created without the
+suffix \fB//TRANSLIT\fP or \fB//IGNORE\fP or \fB//NON_IDENTICAL_DISCARD\fP,
+the conversion is strict: lossy conversions produce this condition.
+If the suffix \fB//TRANSLIT\fP was specified, transliteration can avoid this
+condition in some cases.
+In the musl C library, this condition cannot occur because a conversion to
+\fB\[aq]*\[aq]\fP is used as a fallback.
+In the FreeBSD, NetBSD, and Solaris implementations of \fBiconv\fP, this
+condition cannot occur either, because a conversion to \fB\[aq]?\[aq]\fP is
+used as a fallback.
+When this condition is met, the \fBiconv\fP function sets \fBerrno\fP to
+\fBEILSEQ\fP and returns (size_t)(\-1).
+\fI*inbuf\fP is left pointing to the beginning of the unconvertible multibyte
+sequence.
+.PP
+3. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
 has gone down to 0. In this case \fBiconv\fP returns the number of
 non-reversible conversions performed during this call.
 .PP
-3. An incomplete multibyte sequence is encountered in the input, and the
+4. An incomplete multibyte sequence is encountered in the input, and the
 input byte sequence terminates after it. In this case it sets \fBerrno\fP to
 \fBEINVAL\fP and returns (size_t)(\-1). \fI*inbuf\fP is left pointing to the
 beginning of the incomplete multibyte sequence.
 .PP
-4. The output buffer has no more room for the next converted character. In
+5. The output buffer has no more room for the next converted character. In
 this case it sets \fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1).
 .PP
 A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
@@ -85,8 +104,26 @@ An invalid multibyte sequence has been encountered in the input.
 .B EINVAL
 An incomplete multibyte sequence has been encountered in the input.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
+.SH NOTES
+In each series of calls to the \fBiconv\fP function,
+the last should be one with \fIinbuf\fP or \fI*inbuf\fP equal to NULL,
+in order to complete the conversion of any partially converted input.
+
+Although \fIinbuf\fP and \fIoutbuf\fP are typed as
+\fBconst char **\fP and \fBchar **\fP, respectively,
+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.
+
+The caller of the \fBiconv\fP function
+must ensure that the pointers passed to the function are suitable
+for accessing characters in the appropriate character set.
+For the encodings \fBUCS-2-INTERNAL\fP, \fBUCS-4-INTERNAL\fP, and \fBwchar_t\fP,
+this includes ensuring correct alignment.
 .SH "SEE ALSO"
 .BR iconv_open (3),
-.BR iconvctl (3)
+.BR iconvctl (3),
 .BR iconv_close (3)