@cpp.js/package-iconv 1.0.0 → 2.0.0-beta.2

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv.3

@@ -1,129 +0,0 @@
-.\" Copyright (c) Free Software Foundation, Inc.
-.\"
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 3 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" References consulted:
-.\"   GNU glibc-2 source code and manual
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
-.\"
-.TH ICONV 3  "December 15, 2024" "GNU"
-.SH NAME
-iconv \- perform character set conversion
-.SH SYNOPSIS
-.nf
-.B #include <iconv.h>
-.sp
-.BI "size_t iconv (iconv_t " cd ,
-.BI "              const char* * " inbuf ", size_t * "inbytesleft ,
-.BI "              char* * " outbuf ", size_t * "outbytesleft );
-.fi
-.SH DESCRIPTION
-The argument \fIcd\fP must be a conversion descriptor created using the
-function \fBiconv_open\fP.
-.PP
-The main case is when \fIinbuf\fP is not NULL and \fI*inbuf\fP is not NULL.
-In this case, the \fBiconv\fP function converts the multibyte sequence
-starting at \fI*inbuf\fP to a multibyte sequence starting at \fI*outbuf\fP.
-At most \fI*inbytesleft\fP bytes, starting at \fI*inbuf\fP, will be read.
-At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
-.PP
-The \fBiconv\fP function converts one multibyte character at a time, and for
-each character conversion it increments \fI*inbuf\fP and decrements
-\fI*inbytesleft\fP by the number of converted input bytes, it increments
-\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of converted
-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 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. 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
-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
-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
-\fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL. In this case, the
-\fBiconv\fP function attempts to set \fIcd\fP's conversion state to the
-initial state and store a corresponding shift sequence at \fI*outbuf\fP.
-At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
-If the output buffer has no more room for this reset sequence, it sets
-\fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1). Otherwise it increments
-\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
-written.
-.PP
-A third case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, and
-\fIoutbuf\fP is NULL or \fI*outbuf\fP is NULL. In this case, the \fBiconv\fP
-function sets \fIcd\fP's conversion state to the initial state.
-.SH "RETURN VALUE"
-The \fBiconv\fP function returns the number of characters converted in a
-non-reversible way during this call; reversible conversions are not counted.
-In case of error, it sets \fBerrno\fP and returns (size_t)(\-1).
-.SH ERRORS
-The following errors can occur, among others:
-.TP
-.B E2BIG
-There is not sufficient room at \fI*outbuf\fP.
-.TP
-.B EILSEQ
-An invalid multibyte sequence has been encountered in the input.
-.TP
-.B EINVAL
-An incomplete multibyte sequence has been encountered in the input.
-.SH "CONFORMING TO"
-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 iconv_close (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_close.3

@@ -1,31 +0,0 @@
-.\" Copyright (c) Free Software Foundation, Inc.
-.\"
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 3 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" References consulted:
-.\"   GNU glibc-2 source code and manual
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
-.\"
-.TH ICONV_CLOSE 3  "December 15, 2024" "GNU"
-.SH NAME
-iconv_close \- deallocate descriptor for character set conversion
-.SH SYNOPSIS
-.nf
-.B #include <iconv.h>
-.sp
-.BI "int iconv_close (iconv_t " cd );
-.fi
-.SH DESCRIPTION
-The \fBiconv_close\fP function deallocates a conversion descriptor \fIcd\fP
-previously allocated using \fBiconv_open\fP.
-.SH "RETURN VALUE"
-When successful, the \fBiconv_close\fP function returns 0. In case of error,
-it sets \fBerrno\fP and returns \-1.
-.SH "CONFORMING TO"
-POSIX:2024
-.SH "SEE ALSO"
-.BR iconv_open (3)
-.BR iconv (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open.3

@@ -1,260 +0,0 @@
-.\" Copyright (c) Free Software Foundation, Inc.
-.\"
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 3 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" References consulted:
-.\"   GNU glibc-2 source code and manual
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
-.\"
-.TH ICONV_OPEN 3  "December 15, 2024" "GNU"
-.SH NAME
-iconv_open \- allocate descriptor for character set conversion
-.SH SYNOPSIS
-.nf
-.B #include <iconv.h>
-.sp
-.BI "iconv_t iconv_open (const char* " tocode ", const char* " fromcode );
-.fi
-.SH DESCRIPTION
-The \fBiconv_open\fP function allocates a conversion descriptor suitable
-for converting byte sequences from character encoding \fIfromcode\fP to
-character encoding \fItocode\fP.
-.PP
-The values permitted for \fIfromcode\fP and \fItocode\fP and the supported
-combinations are system dependent. For the libiconv library, the following
-encodings are supported, in all combinations.
-.TP
-European languages
-.nf
-.fi
-ASCII, ISO\-8859\-{1,2,3,4,5,7,9,10,13,14,15,16},
-KOI8\-R, KOI8\-U, KOI8\-RU,
-CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
-Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
-Mac{Cyrillic,Ukraine,Greek,Turkish},
-Macintosh
-.TP
-Semitic languages
-.nf
-.fi
-ISO\-8859\-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
-.TP
-Japanese
-.nf
-.fi
-EUC\-JP, SHIFT_JIS, CP932, ISO\-2022\-JP, ISO\-2022\-JP\-2, ISO\-2022\-JP\-1,
-ISO-2022\-JP\-MS
-.TP
-Chinese
-.nf
-.fi
-EUC\-CN, HZ, GBK, CP936, GB18030, GB18030:2022, EUC\-TW, BIG5, CP950,
-BIG5\-HKSCS, BIG5\-HKSCS:2004, BIG5\-HKSCS:2001, BIG5\-HKSCS:1999,
-ISO\-2022\-CN, ISO\-2022\-CN\-EXT
-.TP
-Korean
-.nf
-.fi
-EUC\-KR, CP949, ISO\-2022\-KR, JOHAB
-.TP
-Armenian
-.nf
-.fi
-ARMSCII\-8
-.TP
-Georgian
-.nf
-.fi
-Georgian\-Academy, Georgian\-PS
-.TP
-Tajik
-.nf
-.fi
-KOI8\-T
-.TP
-Kazakh
-.nf
-.fi
-PT154, RK1048
-.TP
-Thai
-.nf
-.fi
-TIS\-620, CP874, MacThai
-.TP
-Laotian
-.nf
-.fi
-MuleLao\-1, CP1133
-.TP
-Vietnamese
-.nf
-.fi
-VISCII, TCVN, CP1258
-.TP
-Platform specifics
-.nf
-.fi
-HP\-ROMAN8, NEXTSTEP
-.TP
-Full Unicode
-.nf
-.fi
-UTF\-8
-.nf
-.fi
-UCS\-2, UCS\-2BE, UCS\-2LE
-.nf
-.fi
-UCS\-4, UCS\-4BE, UCS\-4LE
-.nf
-.fi
-UTF\-16, UTF\-16BE, UTF\-16LE
-.nf
-.fi
-UTF\-32, UTF\-32BE, UTF\-32LE
-.nf
-.fi
-UTF\-7
-.nf
-.fi
-C99, JAVA
-.TP
-Full Unicode, in terms of \fBuint16_t\fP or \fBuint32_t\fP
-(with machine dependent endianness and alignment)
-.nf
-.fi
-UCS\-2\-INTERNAL, UCS\-4\-INTERNAL
-.TP
-Locale dependent, in terms of \fBchar\fP or \fBwchar_t\fP
-(with machine dependent endianness and alignment, and with semantics
-depending on the OS and the current LC_CTYPE locale facet)
-.nf
-.fi
-char, wchar_t
-.PP
-When configured with the option \fB\-\-enable\-extra\-encodings\fP, it also
-provides support for a few extra encodings:
-.TP
-European languages
-.nf
-CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
-.fi
-.TP
-Semitic languages
-.nf
-.fi
-CP864
-.TP
-Japanese
-.nf
-.fi
-EUC\-JISX0213, Shift_JISX0213, ISO\-2022\-JP\-3
-.TP
-Chinese
-.nf
-.fi
-BIG5\-2003 (experimental)
-.TP
-Turkmen
-.nf
-.fi
-TDS565
-.TP
-Platform specifics
-.nf
-.fi
-ATARIST, RISCOS\-LATIN1
-.PP
-.TP
-EBCDIC compatible (not ASCII compatible, very rarely used)
-.nf
-.fi
-European languages:
-.nf
-.fi
-    IBM-{037,273,277,278,280,282,284,285,297,423,500,870,871,875,880},
-    IBM-{905,924,1025,1026,1047,1112,1122,1123,1140,1141,1142,1143},
-    IBM-{1144,1145,1146,1147,1148,1149,1153,1154,1155,1156,1157,1158},
-    IBM-{1165,1166,4971}
-.nf
-.fi
-Semitic languages:
-.nf
-.fi
-    IBM-{424,425,12712,16804}
-.nf
-.fi
-Persian:
-.nf
-.fi
-    IBM-1097
-.nf
-.fi
-Thai:
-.nf
-.fi
-    IBM-{838,1160}
-.nf
-.fi
-Laotian:
-.nf
-.fi
-    IBM-1132
-.nf
-.fi
-Vietnamese:
-.nf
-.fi
-    IBM-{1130,1164}
-.nf
-.fi
-Indic languages:
-.nf
-.fi
-    IBM-1137
-.PP
-The empty encoding name "" is equivalent to "char": it denotes the
-locale dependent character encoding.
-.PP
-When the string "//TRANSLIT" is appended to \fItocode\fP, 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 characters
-that look similar to the original character.
-.PP
-When the string "//IGNORE" is appended to \fItocode\fP,
-invalid multibyte sequences in the input and
-characters that cannot be represented in the target character set
-will be silently discarded.
-.PP
-When the string "//NON_IDENTICAL_DISCARD" is appended to \fItocode\fP,
-characters that cannot be represented in the target character set
-will be silently discarded.
-.PP
-The resulting conversion descriptor can be used with \fBiconv\fP any number
-of times. It remains valid until deallocated using \fBiconv_close\fP.
-.PP
-A conversion descriptor contains a conversion state. After creation using
-\fBiconv_open\fP, the state is in the initial state. Using \fBiconv\fP
-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 \fBiconv\fP with NULL as \fIinbuf\fP
-argument.
-.SH "RETURN VALUE"
-The \fBiconv_open\fP function returns a freshly allocated conversion
-descriptor. In case of error, it sets \fBerrno\fP and returns (iconv_t)(\-1).
-.SH ERRORS
-The following error can occur, among others:
-.TP
-.B EINVAL
-The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
-implementation.
-.SH "CONFORMING TO"
-POSIX:2024
-.SH "SEE ALSO"
-.BR iconv (3)
-.BR iconvctl (3)
-.BR iconv_close (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open_into.3

@@ -1,47 +0,0 @@
-.\" Copyright (c) Free Software Foundation, Inc.
-.\"
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 3 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" References consulted:
-.\"   iconv.h
-.\"
-.TH ICONV_OPEN_INTO 3  "September 21, 2008" "GNU"
-.SH NAME
-iconv_open_into \- initialize descriptor for character set conversion
-.SH SYNOPSIS
-.nf
-.B #include <iconv.h>
-.sp
-.BI "int iconv_open_into (const char* " tocode ", const char* " fromcode ","
-.BI "                     iconv_allocation_t* " resultp );
-.fi
-.SH DESCRIPTION
-The \fBiconv_open_into\fP function initializes a conversion descriptor suitable
-for converting byte sequences from character encoding \fIfromcode\fP to
-character encoding \fItocode\fP.  The conversion descriptor is stored in the
-memory pointed to by \fIresultp\fP.
-.PP
-The values permitted for \fIfromcode\fP and \fItocode\fP are the same as for
-the function \fBiconv_open\fP.
-.PP
-After a successful return from this function, \fIresultp\fP can be be used
-as an \fBiconv_t\fP object with the \fBiconv\fP function.
-.SH "RETURN VALUE"
-The \fBiconv_open_into\fP function fills \fB*\fP\fIresultp\fP and returns 0 if
-it succeeds. In case of error, it sets \fBerrno\fP and returns \-1.
-.SH ERRORS
-The following error can occur, among others:
-.TP
-.B EINVAL
-The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
-implementation.
-.SH "CONFORMING TO"
-This function is implemented only in GNU libiconv and not in other \fBiconv\fP
-implementations. It is not backed by a standard. You can test for its presence
-through \fB(_LIBICONV_VERSION >= 0x010D)\fP.
-.SH "SEE ALSO"
-.BR iconv_open (3)
-.BR iconv (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconvctl.3

@@ -1,112 +0,0 @@
-.\" Copyright (c) Perry Rapp
-.\" Copyright (c) Free Software Foundation, Inc.
-.\"
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 3 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" References consulted:
-.\"   iconv.h
-.\"
-.TH ICONVCTL 3  "December 15, 2024" "GNU"
-.SH NAME
-iconvctl \- control iconv behavior
-.SH SYNOPSIS
-.nf
-.B #include <iconv.h>
-.sp
-.BI "int iconvctl (iconv_t " cd " , int " request ", void * " argument );
-.fi
-.SH DESCRIPTION
-The argument \fIcd\fP must be a conversion descriptor created using the
-function \fBiconv_open\fP.
-.PP
-\fBiconvctl\fP queries or adjusts the behavior of the \fBiconv\fP function,
-when invoked with the specified conversion descriptor, depending on the
-request value.
-.SH "REQUEST VALUES"
-The following are permissible values for the \fIrequest\fP parameter.
-.TP
-.B ICONV_TRIVIALP
-\fIargument\fP should be an \fBint *\fP which will receive 1 if the
-conversion is trivial, or 0 otherwise.
-.TP
-.B ICONV_GET_TRANSLITERATE
-\fIargument\fP should be an \fBint *\fP which will receive 1 if 
-transliteration is enabled in the conversion, or 0 otherwise.
-.TP
-.B ICONV_SET_TRANSLITERATE
-\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
-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 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 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.
-.SH ERRORS
-The following errors can occur, among others:
-.TP
-.B EINVAL
-The request is invalid.
-.SH "CONFORMING TO"
-This function is implemented only in GNU libiconv and not in other \fBiconv\fP
-implementations. It is not backed by a standard. You can test for its presence
-through \fB(_LIBICONV_VERSION >= 0x0108)\fP.
-.SH "SEE ALSO"
-.BR iconv_open (3)
-.BR iconv (3)