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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/cppjs.config.js +12 -16
  2. package/package.json +7 -11
  3. package/charset.xcframework/Info.plist +0 -50
  4. package/charset.xcframework/ios-arm64_arm64e/Headers/iconv.h +0 -243
  5. package/charset.xcframework/ios-arm64_arm64e/Headers/libcharset.h +0 -45
  6. package/charset.xcframework/ios-arm64_arm64e/Headers/localcharset.h +0 -137
  7. package/charset.xcframework/ios-arm64_arm64e/libcharset.a +0 -0
  8. package/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +0 -243
  9. package/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +0 -45
  10. package/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +0 -137
  11. package/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/libcharset.a +0 -0
  12. package/dist/prebuilt/Android-arm64-v8a/include/iconv.h +0 -243
  13. package/dist/prebuilt/Android-arm64-v8a/include/libcharset.h +0 -45
  14. package/dist/prebuilt/Android-arm64-v8a/include/localcharset.h +0 -137
  15. package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.la +0 -41
  16. package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.so +0 -0
  17. package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.la +0 -41
  18. package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.so +0 -0
  19. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.1.html +0 -217
  20. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.3.html +0 -255
  21. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_close.3.html +0 -89
  22. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open.3.html +0 -352
  23. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open_into.3.html +0 -132
  24. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconvctl.3.html +0 -244
  25. package/dist/prebuilt/Android-arm64-v8a/share/man/man1/iconv.1 +0 -112
  26. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv.3 +0 -129
  27. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_close.3 +0 -31
  28. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open.3 +0 -260
  29. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open_into.3 +0 -47
  30. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconvctl.3 +0 -112
  31. package/dist/prebuilt/Android-x86_64/include/iconv.h +0 -243
  32. package/dist/prebuilt/Android-x86_64/include/libcharset.h +0 -45
  33. package/dist/prebuilt/Android-x86_64/include/localcharset.h +0 -137
  34. package/dist/prebuilt/Android-x86_64/lib/libcharset.la +0 -41
  35. package/dist/prebuilt/Android-x86_64/lib/libcharset.so +0 -0
  36. package/dist/prebuilt/Android-x86_64/lib/libiconv.la +0 -41
  37. package/dist/prebuilt/Android-x86_64/lib/libiconv.so +0 -0
  38. package/dist/prebuilt/Android-x86_64/share/doc/iconv.1.html +0 -217
  39. package/dist/prebuilt/Android-x86_64/share/doc/iconv.3.html +0 -255
  40. package/dist/prebuilt/Android-x86_64/share/doc/iconv_close.3.html +0 -89
  41. package/dist/prebuilt/Android-x86_64/share/doc/iconv_open.3.html +0 -352
  42. package/dist/prebuilt/Android-x86_64/share/doc/iconv_open_into.3.html +0 -132
  43. package/dist/prebuilt/Android-x86_64/share/doc/iconvctl.3.html +0 -244
  44. package/dist/prebuilt/Android-x86_64/share/man/man1/iconv.1 +0 -112
  45. package/dist/prebuilt/Android-x86_64/share/man/man3/iconv.3 +0 -129
  46. package/dist/prebuilt/Android-x86_64/share/man/man3/iconv_close.3 +0 -31
  47. package/dist/prebuilt/Android-x86_64/share/man/man3/iconv_open.3 +0 -260
  48. package/dist/prebuilt/Android-x86_64/share/man/man3/iconv_open_into.3 +0 -47
  49. package/dist/prebuilt/Android-x86_64/share/man/man3/iconvctl.3 +0 -112
  50. package/dist/prebuilt/CMakeLists.txt +0 -44
  51. package/dist/prebuilt/Emscripten-x86_64/include/iconv.h +0 -243
  52. package/dist/prebuilt/Emscripten-x86_64/include/libcharset.h +0 -45
  53. package/dist/prebuilt/Emscripten-x86_64/include/localcharset.h +0 -137
  54. package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.a +0 -0
  55. package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.la +0 -41
  56. package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.a +0 -0
  57. package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.la +0 -41
  58. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.1.html +0 -217
  59. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.3.html +0 -255
  60. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_close.3.html +0 -89
  61. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open.3.html +0 -352
  62. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open_into.3.html +0 -132
  63. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconvctl.3.html +0 -244
  64. package/dist/prebuilt/Emscripten-x86_64/share/locale/af/LC_MESSAGES/libiconv.mo +0 -0
  65. package/dist/prebuilt/Emscripten-x86_64/share/locale/be/LC_MESSAGES/libiconv.mo +0 -0
  66. package/dist/prebuilt/Emscripten-x86_64/share/locale/bg/LC_MESSAGES/libiconv.mo +0 -0
  67. package/dist/prebuilt/Emscripten-x86_64/share/locale/ca/LC_MESSAGES/libiconv.mo +0 -0
  68. package/dist/prebuilt/Emscripten-x86_64/share/locale/cs/LC_MESSAGES/libiconv.mo +0 -0
  69. package/dist/prebuilt/Emscripten-x86_64/share/locale/da/LC_MESSAGES/libiconv.mo +0 -0
  70. package/dist/prebuilt/Emscripten-x86_64/share/locale/de/LC_MESSAGES/libiconv.mo +0 -0
  71. package/dist/prebuilt/Emscripten-x86_64/share/locale/el/LC_MESSAGES/libiconv.mo +0 -0
  72. package/dist/prebuilt/Emscripten-x86_64/share/locale/eo/LC_MESSAGES/libiconv.mo +0 -0
  73. package/dist/prebuilt/Emscripten-x86_64/share/locale/es/LC_MESSAGES/libiconv.mo +0 -0
  74. package/dist/prebuilt/Emscripten-x86_64/share/locale/et/LC_MESSAGES/libiconv.mo +0 -0
  75. package/dist/prebuilt/Emscripten-x86_64/share/locale/fi/LC_MESSAGES/libiconv.mo +0 -0
  76. package/dist/prebuilt/Emscripten-x86_64/share/locale/fr/LC_MESSAGES/libiconv.mo +0 -0
  77. package/dist/prebuilt/Emscripten-x86_64/share/locale/ga/LC_MESSAGES/libiconv.mo +0 -0
  78. package/dist/prebuilt/Emscripten-x86_64/share/locale/gl/LC_MESSAGES/libiconv.mo +0 -0
  79. package/dist/prebuilt/Emscripten-x86_64/share/locale/hr/LC_MESSAGES/libiconv.mo +0 -0
  80. package/dist/prebuilt/Emscripten-x86_64/share/locale/hu/LC_MESSAGES/libiconv.mo +0 -0
  81. package/dist/prebuilt/Emscripten-x86_64/share/locale/id/LC_MESSAGES/libiconv.mo +0 -0
  82. package/dist/prebuilt/Emscripten-x86_64/share/locale/it/LC_MESSAGES/libiconv.mo +0 -0
  83. package/dist/prebuilt/Emscripten-x86_64/share/locale/ja/LC_MESSAGES/libiconv.mo +0 -0
  84. package/dist/prebuilt/Emscripten-x86_64/share/locale/ka/LC_MESSAGES/libiconv.mo +0 -0
  85. package/dist/prebuilt/Emscripten-x86_64/share/locale/ko/LC_MESSAGES/libiconv.mo +0 -0
  86. package/dist/prebuilt/Emscripten-x86_64/share/locale/lt/LC_MESSAGES/libiconv.mo +0 -0
  87. package/dist/prebuilt/Emscripten-x86_64/share/locale/nl/LC_MESSAGES/libiconv.mo +0 -0
  88. package/dist/prebuilt/Emscripten-x86_64/share/locale/pl/LC_MESSAGES/libiconv.mo +0 -0
  89. package/dist/prebuilt/Emscripten-x86_64/share/locale/pt_BR/LC_MESSAGES/libiconv.mo +0 -0
  90. package/dist/prebuilt/Emscripten-x86_64/share/locale/rm/LC_MESSAGES/libiconv.mo +0 -0
  91. package/dist/prebuilt/Emscripten-x86_64/share/locale/ro/LC_MESSAGES/libiconv.mo +0 -0
  92. package/dist/prebuilt/Emscripten-x86_64/share/locale/ru/LC_MESSAGES/libiconv.mo +0 -0
  93. package/dist/prebuilt/Emscripten-x86_64/share/locale/sk/LC_MESSAGES/libiconv.mo +0 -0
  94. package/dist/prebuilt/Emscripten-x86_64/share/locale/sl/LC_MESSAGES/libiconv.mo +0 -0
  95. package/dist/prebuilt/Emscripten-x86_64/share/locale/sq/LC_MESSAGES/libiconv.mo +0 -0
  96. package/dist/prebuilt/Emscripten-x86_64/share/locale/sr/LC_MESSAGES/libiconv.mo +0 -0
  97. package/dist/prebuilt/Emscripten-x86_64/share/locale/sv/LC_MESSAGES/libiconv.mo +0 -0
  98. package/dist/prebuilt/Emscripten-x86_64/share/locale/tr/LC_MESSAGES/libiconv.mo +0 -0
  99. package/dist/prebuilt/Emscripten-x86_64/share/locale/uk/LC_MESSAGES/libiconv.mo +0 -0
  100. package/dist/prebuilt/Emscripten-x86_64/share/locale/vi/LC_MESSAGES/libiconv.mo +0 -0
  101. package/dist/prebuilt/Emscripten-x86_64/share/locale/wa/LC_MESSAGES/libiconv.mo +0 -0
  102. package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_CN/LC_MESSAGES/libiconv.mo +0 -0
  103. package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_TW/LC_MESSAGES/libiconv.mo +0 -0
  104. package/dist/prebuilt/Emscripten-x86_64/share/man/man1/iconv.1 +0 -112
  105. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv.3 +0 -129
  106. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_close.3 +0 -31
  107. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open.3 +0 -260
  108. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open_into.3 +0 -47
  109. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconvctl.3 +0 -112
  110. package/dist/prebuilt/iOS-iphoneos/include/iconv.h +0 -243
  111. package/dist/prebuilt/iOS-iphoneos/include/libcharset.h +0 -45
  112. package/dist/prebuilt/iOS-iphoneos/include/localcharset.h +0 -137
  113. package/dist/prebuilt/iOS-iphoneos/lib/libcharset.a +0 -0
  114. package/dist/prebuilt/iOS-iphoneos/lib/libcharset.la +0 -41
  115. package/dist/prebuilt/iOS-iphoneos/lib/libiconv.a +0 -0
  116. package/dist/prebuilt/iOS-iphoneos/lib/libiconv.la +0 -41
  117. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.1.html +0 -217
  118. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.3.html +0 -255
  119. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_close.3.html +0 -89
  120. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open.3.html +0 -352
  121. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open_into.3.html +0 -132
  122. package/dist/prebuilt/iOS-iphoneos/share/doc/iconvctl.3.html +0 -244
  123. package/dist/prebuilt/iOS-iphoneos/share/man/man1/iconv.1 +0 -112
  124. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv.3 +0 -129
  125. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_close.3 +0 -31
  126. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open.3 +0 -260
  127. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open_into.3 +0 -47
  128. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconvctl.3 +0 -112
  129. package/dist/prebuilt/iOS-iphonesimulator/include/iconv.h +0 -243
  130. package/dist/prebuilt/iOS-iphonesimulator/include/libcharset.h +0 -45
  131. package/dist/prebuilt/iOS-iphonesimulator/include/localcharset.h +0 -137
  132. package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.a +0 -0
  133. package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.la +0 -41
  134. package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.a +0 -0
  135. package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.la +0 -41
  136. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.1.html +0 -217
  137. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.3.html +0 -255
  138. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_close.3.html +0 -89
  139. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open.3.html +0 -352
  140. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open_into.3.html +0 -132
  141. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconvctl.3.html +0 -244
  142. package/dist/prebuilt/iOS-iphonesimulator/share/man/man1/iconv.1 +0 -112
  143. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv.3 +0 -129
  144. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_close.3 +0 -31
  145. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open.3 +0 -260
  146. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open_into.3 +0 -47
  147. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconvctl.3 +0 -112
  148. package/iconv.xcframework/Info.plist +0 -50
  149. package/iconv.xcframework/ios-arm64_arm64e/Headers/iconv.h +0 -243
  150. package/iconv.xcframework/ios-arm64_arm64e/Headers/libcharset.h +0 -45
  151. package/iconv.xcframework/ios-arm64_arm64e/Headers/localcharset.h +0 -137
  152. package/iconv.xcframework/ios-arm64_arm64e/libiconv.a +0 -0
  153. package/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +0 -243
  154. package/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +0 -45
  155. package/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +0 -137
  156. package/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/libiconv.a +0 -0
@@ -1,255 +0,0 @@
1
- <!-- Creator : groff version 1.22.3 -->
2
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3
- "http://www.w3.org/TR/html4/loose.dtd">
4
- <html>
5
- <head>
6
- <meta name="generator" content="groff -Thtml, see www.gnu.org">
7
- <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
8
- <meta name="Content-Style" content="text/css">
9
- <style type="text/css">
10
- p { margin-top: 0; margin-bottom: 0; vertical-align: top }
11
- pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
12
- table { margin-top: 0; margin-bottom: 0; vertical-align: top }
13
- h1 { text-align: center }
14
- </style>
15
- <title>ICONV</title>
16
-
17
- </head>
18
- <body>
19
-
20
- <h1 align="center">ICONV</h1>
21
-
22
- <a href="#NAME">NAME</a><br>
23
- <a href="#SYNOPSIS">SYNOPSIS</a><br>
24
- <a href="#DESCRIPTION">DESCRIPTION</a><br>
25
- <a href="#RETURN VALUE">RETURN VALUE</a><br>
26
- <a href="#ERRORS">ERRORS</a><br>
27
- <a href="#CONFORMING TO">CONFORMING TO</a><br>
28
- <a href="#NOTES">NOTES</a><br>
29
- <a href="#SEE ALSO">SEE ALSO</a><br>
30
-
31
- <hr>
32
-
33
-
34
- <h2>NAME
35
- <a name="NAME"></a>
36
- </h2>
37
-
38
-
39
- <p style="margin-left:11%; margin-top: 1em">iconv &minus;
40
- perform character set conversion</p>
41
-
42
- <h2>SYNOPSIS
43
- <a name="SYNOPSIS"></a>
44
- </h2>
45
-
46
-
47
- <p style="margin-left:11%; margin-top: 1em"><b>#include
48
- &lt;iconv.h&gt;</b></p>
49
-
50
- <p style="margin-left:11%; margin-top: 1em"><b>size_t iconv
51
- (iconv_t</b> <i>cd</i><b>, <br>
52
- const char* *</b> <i>inbuf</i><b>, size_t *</b>
53
- <i>inbytesleft</i><b>, <br>
54
- char* *</b> <i>outbuf</i><b>, size_t *</b>
55
- <i>outbytesleft</i><b>);</b></p>
56
-
57
- <h2>DESCRIPTION
58
- <a name="DESCRIPTION"></a>
59
- </h2>
60
-
61
-
62
- <p style="margin-left:11%; margin-top: 1em">The argument
63
- <i>cd</i> must be a conversion descriptor created using the
64
- function <b>iconv_open</b>.</p>
65
-
66
- <p style="margin-left:11%; margin-top: 1em">The main case
67
- is when <i>inbuf</i> is not NULL and <i>*inbuf</i> is not
68
- NULL. In this case, the <b>iconv</b> function converts the
69
- multibyte sequence starting at <i>*inbuf</i> to a multibyte
70
- sequence starting at <i>*outbuf</i>. At most
71
- <i>*inbytesleft</i> bytes, starting at <i>*inbuf</i>, will
72
- be read. At most <i>*outbytesleft</i> bytes, starting at
73
- <i>*outbuf</i>, will be written.</p>
74
-
75
- <p style="margin-left:11%; margin-top: 1em">The
76
- <b>iconv</b> function converts one multibyte character at a
77
- time, and for each character conversion it increments
78
- <i>*inbuf</i> and decrements <i>*inbytesleft</i> by the
79
- number of converted input bytes, it increments
80
- <i>*outbuf</i> and decrements <i>*outbytesleft</i> by the
81
- number of converted output bytes, and it updates the
82
- conversion state contained in <i>cd</i>. If the character
83
- encoding of the input is stateful, the <b>iconv</b> function
84
- can also convert a sequence of input bytes to an update of
85
- the conversion state without producing any output bytes;
86
- such input is called a <i>shift sequence</i>. The conversion
87
- can stop for five reasons:</p>
88
-
89
- <p style="margin-left:11%; margin-top: 1em">1. An invalid
90
- multibyte sequence is encountered in the input. In this case
91
- it sets <b>errno</b> to <b>EILSEQ</b> and returns
92
- (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
93
- beginning of the invalid multibyte sequence.</p>
94
-
95
- <p style="margin-left:11%; margin-top: 1em">2. A multibyte
96
- sequence is encountered that is valid but that cannot be
97
- translated to the character encoding of the output. This
98
- condition depends on the implementation and on the
99
- conversion descriptor. In the GNU C library and GNU
100
- libiconv, if <i>cd</i> was created without the suffix
101
- <b>//TRANSLIT</b> or <b>//IGNORE</b> or
102
- <b>//NON_IDENTICAL_DISCARD</b>, the conversion is strict:
103
- lossy conversions produce this condition. If the suffix
104
- <b>//TRANSLIT</b> was specified, transliteration can avoid
105
- this condition in some cases. In the musl C library, this
106
- condition cannot occur because a conversion to <b>'*'</b> is
107
- used as a fallback. In the FreeBSD, NetBSD, and Solaris
108
- implementations of <b>iconv</b>, this condition cannot occur
109
- either, because a conversion to <b>'?'</b> is used as a
110
- fallback. When this condition is met, the <b>iconv</b>
111
- function sets <b>errno</b> to <b>EILSEQ</b> and returns
112
- (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
113
- beginning of the unconvertible multibyte sequence.</p>
114
-
115
- <p style="margin-left:11%; margin-top: 1em">3. The input
116
- byte sequence has been entirely converted, i.e.
117
- <i>*inbytesleft</i> has gone down to 0. In this case
118
- <b>iconv</b> returns the number of non-reversible
119
- conversions performed during this call.</p>
120
-
121
- <p style="margin-left:11%; margin-top: 1em">4. An
122
- incomplete multibyte sequence is encountered in the input,
123
- and the input byte sequence terminates after it. In this
124
- case it sets <b>errno</b> to <b>EINVAL</b> and returns
125
- (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
126
- beginning of the incomplete multibyte sequence.</p>
127
-
128
- <p style="margin-left:11%; margin-top: 1em">5. The output
129
- buffer has no more room for the next converted character. In
130
- this case it sets <b>errno</b> to <b>E2BIG</b> and returns
131
- (size_t)(&minus;1).</p>
132
-
133
- <p style="margin-left:11%; margin-top: 1em">A different
134
- case is when <i>inbuf</i> is NULL or <i>*inbuf</i> is NULL,
135
- but <i>outbuf</i> is not NULL and <i>*outbuf</i> is not
136
- NULL. In this case, the <b>iconv</b> function attempts to
137
- set <i>cd</i>&rsquo;s conversion state to the initial state
138
- and store a corresponding shift sequence at <i>*outbuf</i>.
139
- At most <i>*outbytesleft</i> bytes, starting at
140
- <i>*outbuf</i>, will be written. If the output buffer has no
141
- more room for this reset sequence, it sets <b>errno</b> to
142
- <b>E2BIG</b> and returns (size_t)(&minus;1). Otherwise it
143
- increments <i>*outbuf</i> and decrements
144
- <i>*outbytesleft</i> by the number of bytes written.</p>
145
-
146
- <p style="margin-left:11%; margin-top: 1em">A third case is
147
- when <i>inbuf</i> is NULL or <i>*inbuf</i> is NULL, and
148
- <i>outbuf</i> is NULL or <i>*outbuf</i> is NULL. In this
149
- case, the <b>iconv</b> function sets <i>cd</i>&rsquo;s
150
- conversion state to the initial state.</p>
151
-
152
- <h2>RETURN VALUE
153
- <a name="RETURN VALUE"></a>
154
- </h2>
155
-
156
-
157
- <p style="margin-left:11%; margin-top: 1em">The
158
- <b>iconv</b> function returns the number of characters
159
- converted in a non-reversible way during this call;
160
- reversible conversions are not counted. In case of error, it
161
- sets <b>errno</b> and returns (size_t)(&minus;1).</p>
162
-
163
- <h2>ERRORS
164
- <a name="ERRORS"></a>
165
- </h2>
166
-
167
-
168
- <p style="margin-left:11%; margin-top: 1em">The following
169
- errors can occur, among others:</p>
170
-
171
- <table width="100%" border="0" rules="none" frame="void"
172
- cellspacing="0" cellpadding="0">
173
- <tr valign="top" align="left">
174
- <td width="11%"></td>
175
- <td width="9%">
176
-
177
-
178
- <p><b>E2BIG</b></p></td>
179
- <td width="2%"></td>
180
- <td width="78%">
181
-
182
-
183
- <p>There is not sufficient room at <i>*outbuf</i>.</p></td></tr>
184
- <tr valign="top" align="left">
185
- <td width="11%"></td>
186
- <td width="9%">
187
-
188
-
189
- <p><b>EILSEQ</b></p></td>
190
- <td width="2%"></td>
191
- <td width="78%">
192
-
193
-
194
- <p>An invalid multibyte sequence has been encountered in
195
- the input.</p></td></tr>
196
- <tr valign="top" align="left">
197
- <td width="11%"></td>
198
- <td width="9%">
199
-
200
-
201
- <p><b>EINVAL</b></p></td>
202
- <td width="2%"></td>
203
- <td width="78%">
204
-
205
-
206
- <p>An incomplete multibyte sequence has been encountered in
207
- the input.</p></td></tr>
208
- </table>
209
-
210
- <h2>CONFORMING TO
211
- <a name="CONFORMING TO"></a>
212
- </h2>
213
-
214
-
215
- <p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
216
-
217
- <h2>NOTES
218
- <a name="NOTES"></a>
219
- </h2>
220
-
221
-
222
- <p style="margin-left:11%; margin-top: 1em">In each series
223
- of calls to the <b>iconv</b> function, the last should be
224
- one with <i>inbuf</i> or <i>*inbuf</i> equal to NULL, in
225
- order to complete the conversion of any partially converted
226
- input.</p>
227
-
228
- <p style="margin-left:11%; margin-top: 1em">Although
229
- <i>inbuf</i> and <i>outbuf</i> are typed as <b>const char
230
- **</b> and <b>char **</b>, respectively, this does not mean
231
- that the objects they point can be interpreted as C strings
232
- or as arrays of characters: the interpretation of character
233
- byte sequences is handled internally by the conversion
234
- functions. In some encodings, a zero byte may be a valid
235
- part of a multibyte character.</p>
236
-
237
- <p style="margin-left:11%; margin-top: 1em">The caller of
238
- the <b>iconv</b> function must ensure that the pointers
239
- passed to the function are suitable for accessing characters
240
- in the appropriate character set. For the encodings
241
- <b>UCS-2-INTERNAL</b>, <b>UCS-4-INTERNAL</b>, and
242
- <b>wchar_t</b>, this includes ensuring correct
243
- alignment.</p>
244
-
245
- <h2>SEE ALSO
246
- <a name="SEE ALSO"></a>
247
- </h2>
248
-
249
-
250
-
251
- <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3),
252
- <b>iconvctl</b>(3), <b>iconv_close</b>(3)</p>
253
- <hr>
254
- </body>
255
- </html>
@@ -1,89 +0,0 @@
1
- <!-- Creator : groff version 1.22.3 -->
2
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3
- "http://www.w3.org/TR/html4/loose.dtd">
4
- <html>
5
- <head>
6
- <meta name="generator" content="groff -Thtml, see www.gnu.org">
7
- <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
8
- <meta name="Content-Style" content="text/css">
9
- <style type="text/css">
10
- p { margin-top: 0; margin-bottom: 0; vertical-align: top }
11
- pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
12
- table { margin-top: 0; margin-bottom: 0; vertical-align: top }
13
- h1 { text-align: center }
14
- </style>
15
- <title>ICONV_CLOSE</title>
16
-
17
- </head>
18
- <body>
19
-
20
- <h1 align="center">ICONV_CLOSE</h1>
21
-
22
- <a href="#NAME">NAME</a><br>
23
- <a href="#SYNOPSIS">SYNOPSIS</a><br>
24
- <a href="#DESCRIPTION">DESCRIPTION</a><br>
25
- <a href="#RETURN VALUE">RETURN VALUE</a><br>
26
- <a href="#CONFORMING TO">CONFORMING TO</a><br>
27
- <a href="#SEE ALSO">SEE ALSO</a><br>
28
-
29
- <hr>
30
-
31
-
32
- <h2>NAME
33
- <a name="NAME"></a>
34
- </h2>
35
-
36
-
37
- <p style="margin-left:11%; margin-top: 1em">iconv_close
38
- &minus; deallocate descriptor for character set
39
- conversion</p>
40
-
41
- <h2>SYNOPSIS
42
- <a name="SYNOPSIS"></a>
43
- </h2>
44
-
45
-
46
- <p style="margin-left:11%; margin-top: 1em"><b>#include
47
- &lt;iconv.h&gt;</b></p>
48
-
49
- <p style="margin-left:11%; margin-top: 1em"><b>int
50
- iconv_close (iconv_t</b> <i>cd</i><b>);</b></p>
51
-
52
- <h2>DESCRIPTION
53
- <a name="DESCRIPTION"></a>
54
- </h2>
55
-
56
-
57
- <p style="margin-left:11%; margin-top: 1em">The
58
- <b>iconv_close</b> function deallocates a conversion
59
- descriptor <i>cd</i> previously allocated using
60
- <b>iconv_open</b>.</p>
61
-
62
- <h2>RETURN VALUE
63
- <a name="RETURN VALUE"></a>
64
- </h2>
65
-
66
-
67
- <p style="margin-left:11%; margin-top: 1em">When
68
- successful, the <b>iconv_close</b> function returns 0. In
69
- case of error, it sets <b>errno</b> and returns
70
- &minus;1.</p>
71
-
72
- <h2>CONFORMING TO
73
- <a name="CONFORMING TO"></a>
74
- </h2>
75
-
76
-
77
- <p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
78
-
79
- <h2>SEE ALSO
80
- <a name="SEE ALSO"></a>
81
- </h2>
82
-
83
-
84
-
85
- <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3)
86
- <b>iconv</b>(3)</p>
87
- <hr>
88
- </body>
89
- </html>
@@ -1,352 +0,0 @@
1
- <!-- Creator : groff version 1.22.3 -->
2
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3
- "http://www.w3.org/TR/html4/loose.dtd">
4
- <html>
5
- <head>
6
- <meta name="generator" content="groff -Thtml, see www.gnu.org">
7
- <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
8
- <meta name="Content-Style" content="text/css">
9
- <style type="text/css">
10
- p { margin-top: 0; margin-bottom: 0; vertical-align: top }
11
- pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
12
- table { margin-top: 0; margin-bottom: 0; vertical-align: top }
13
- h1 { text-align: center }
14
- </style>
15
- <title>ICONV_OPEN</title>
16
-
17
- </head>
18
- <body>
19
-
20
- <h1 align="center">ICONV_OPEN</h1>
21
-
22
- <a href="#NAME">NAME</a><br>
23
- <a href="#SYNOPSIS">SYNOPSIS</a><br>
24
- <a href="#DESCRIPTION">DESCRIPTION</a><br>
25
- <a href="#RETURN VALUE">RETURN VALUE</a><br>
26
- <a href="#ERRORS">ERRORS</a><br>
27
- <a href="#CONFORMING TO">CONFORMING TO</a><br>
28
- <a href="#SEE ALSO">SEE ALSO</a><br>
29
-
30
- <hr>
31
-
32
-
33
- <h2>NAME
34
- <a name="NAME"></a>
35
- </h2>
36
-
37
-
38
- <p style="margin-left:11%; margin-top: 1em">iconv_open
39
- &minus; allocate descriptor for character set conversion</p>
40
-
41
- <h2>SYNOPSIS
42
- <a name="SYNOPSIS"></a>
43
- </h2>
44
-
45
-
46
- <p style="margin-left:11%; margin-top: 1em"><b>#include
47
- &lt;iconv.h&gt;</b></p>
48
-
49
- <p style="margin-left:11%; margin-top: 1em"><b>iconv_t
50
- iconv_open (const char*</b> <i>tocode</i><b>, const
51
- char*</b> <i>fromcode</i><b>);</b></p>
52
-
53
- <h2>DESCRIPTION
54
- <a name="DESCRIPTION"></a>
55
- </h2>
56
-
57
-
58
- <p style="margin-left:11%; margin-top: 1em">The
59
- <b>iconv_open</b> function allocates a conversion descriptor
60
- suitable for converting byte sequences from character
61
- encoding <i>fromcode</i> to character encoding
62
- <i>tocode</i>.</p>
63
-
64
- <p style="margin-left:11%; margin-top: 1em">The values
65
- permitted for <i>fromcode</i> and <i>tocode</i> and the
66
- supported combinations are system dependent. For the
67
- libiconv library, the following encodings are supported, in
68
- all combinations. <br>
69
- European languages</p>
70
-
71
- <p style="margin-left:22%;">ASCII,
72
- ISO&minus;8859&minus;{1,2,3,4,5,7,9,10,13,14,15,16},
73
- KOI8&minus;R, KOI8&minus;U, KOI8&minus;RU,
74
- CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
75
- Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
76
- Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh</p>
77
-
78
- <p style="margin-left:11%;">Semitic languages</p>
79
-
80
- <p style="margin-left:22%;">ISO&minus;8859&minus;{6,8},
81
- CP{1255,1256}, CP862, Mac{Hebrew,Arabic}</p>
82
-
83
- <p style="margin-left:11%;">Japanese</p>
84
-
85
- <p style="margin-left:22%;">EUC&minus;JP, SHIFT_JIS, CP932,
86
- ISO&minus;2022&minus;JP, ISO&minus;2022&minus;JP&minus;2,
87
- ISO&minus;2022&minus;JP&minus;1,
88
- ISO-2022&minus;JP&minus;MS</p>
89
-
90
- <p style="margin-left:11%;">Chinese</p>
91
-
92
- <p style="margin-left:22%;">EUC&minus;CN, HZ, GBK, CP936,
93
- GB18030, GB18030:2022, EUC&minus;TW, BIG5, CP950,
94
- BIG5&minus;HKSCS, BIG5&minus;HKSCS:2004,
95
- BIG5&minus;HKSCS:2001, BIG5&minus;HKSCS:1999,
96
- ISO&minus;2022&minus;CN,
97
- ISO&minus;2022&minus;CN&minus;EXT</p>
98
-
99
- <table width="100%" border="0" rules="none" frame="void"
100
- cellspacing="0" cellpadding="0">
101
- <tr valign="top" align="left">
102
- <td width="11%"></td>
103
- <td width="9%">
104
-
105
-
106
- <p>Korean</p></td>
107
- <td width="2%"></td>
108
- <td width="50%">
109
-
110
-
111
- <p>EUC&minus;KR, CP949, ISO&minus;2022&minus;KR, JOHAB</p></td>
112
- <td width="28%">
113
- </td></tr>
114
- </table>
115
-
116
- <p style="margin-left:11%;">Armenian</p>
117
-
118
- <p style="margin-left:22%;">ARMSCII&minus;8</p>
119
-
120
- <p style="margin-left:11%;">Georgian</p>
121
-
122
- <p style="margin-left:22%;">Georgian&minus;Academy,
123
- Georgian&minus;PS</p>
124
-
125
- <table width="100%" border="0" rules="none" frame="void"
126
- cellspacing="0" cellpadding="0">
127
- <tr valign="top" align="left">
128
- <td width="11%"></td>
129
- <td width="9%">
130
-
131
-
132
- <p>Tajik</p></td>
133
- <td width="2%"></td>
134
- <td width="35%">
135
-
136
-
137
- <p>KOI8&minus;T</p></td>
138
- <td width="43%">
139
- </td></tr>
140
- <tr valign="top" align="left">
141
- <td width="11%"></td>
142
- <td width="9%">
143
-
144
-
145
- <p>Kazakh</p></td>
146
- <td width="2%"></td>
147
- <td width="35%">
148
-
149
-
150
- <p>PT154, RK1048</p></td>
151
- <td width="43%">
152
- </td></tr>
153
- <tr valign="top" align="left">
154
- <td width="11%"></td>
155
- <td width="9%">
156
-
157
-
158
- <p>Thai</p></td>
159
- <td width="2%"></td>
160
- <td width="35%">
161
-
162
-
163
- <p>TIS&minus;620, CP874, MacThai</p></td>
164
- <td width="43%">
165
- </td></tr>
166
- </table>
167
-
168
- <p style="margin-left:11%;">Laotian</p>
169
-
170
- <p style="margin-left:22%;">MuleLao&minus;1, CP1133</p>
171
-
172
- <p style="margin-left:11%;">Vietnamese</p>
173
-
174
- <p style="margin-left:22%;">VISCII, TCVN, CP1258</p>
175
-
176
- <p style="margin-left:11%;">Platform specifics</p>
177
-
178
- <p style="margin-left:22%;">HP&minus;ROMAN8, NEXTSTEP</p>
179
-
180
- <p style="margin-left:11%;">Full Unicode</p>
181
-
182
- <p style="margin-left:22%;">UTF&minus;8 <br>
183
- UCS&minus;2, UCS&minus;2BE, UCS&minus;2LE <br>
184
- UCS&minus;4, UCS&minus;4BE, UCS&minus;4LE <br>
185
- UTF&minus;16, UTF&minus;16BE, UTF&minus;16LE <br>
186
- UTF&minus;32, UTF&minus;32BE, UTF&minus;32LE <br>
187
- UTF&minus;7 <br>
188
- C99, JAVA</p>
189
-
190
- <p style="margin-left:11%;">Full Unicode, in terms of
191
- <b>uint16_t</b> or <b>uint32_t</b></p>
192
-
193
- <p style="margin-left:22%;">(with machine dependent
194
- endianness and alignment) <br>
195
- UCS&minus;2&minus;INTERNAL, UCS&minus;4&minus;INTERNAL</p>
196
-
197
- <p style="margin-left:11%;">Locale dependent, in terms of
198
- <b>char</b> or <b>wchar_t</b></p>
199
-
200
- <p style="margin-left:22%;">(with machine dependent
201
- endianness and alignment, and with semantics depending on
202
- the OS and the current LC_CTYPE locale facet) <br>
203
- char, wchar_t</p>
204
-
205
- <p style="margin-left:11%; margin-top: 1em">When configured
206
- with the option
207
- <b>&minus;&minus;enable&minus;extra&minus;encodings</b>, it
208
- also provides support for a few extra encodings: <br>
209
- European languages</p>
210
-
211
-
212
- <p style="margin-left:22%;">CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}</p>
213
-
214
- <p style="margin-left:11%;">Semitic languages</p>
215
-
216
- <p style="margin-left:22%;">CP864</p>
217
-
218
- <p style="margin-left:11%;">Japanese</p>
219
-
220
- <p style="margin-left:22%;">EUC&minus;JISX0213,
221
- Shift_JISX0213, ISO&minus;2022&minus;JP&minus;3</p>
222
-
223
- <p style="margin-left:11%;">Chinese</p>
224
-
225
- <p style="margin-left:22%;">BIG5&minus;2003
226
- (experimental)</p>
227
-
228
- <p style="margin-left:11%;">Turkmen</p>
229
-
230
- <p style="margin-left:22%;">TDS565</p>
231
-
232
- <p style="margin-left:11%;">Platform specifics</p>
233
-
234
- <p style="margin-left:22%;">ATARIST,
235
- RISCOS&minus;LATIN1</p>
236
-
237
- <p style="margin-left:11%;">EBCDIC compatible (not ASCII
238
- compatible, very rarely used)</p>
239
-
240
- <p style="margin-left:22%;">European languages: <br>
241
-
242
- IBM-{037,273,277,278,280,282,284,285,297,423,500,870,871,875,880},
243
- <br>
244
-
245
- IBM-{905,924,1025,1026,1047,1112,1122,1123,1140,1141,1142,1143},
246
- <br>
247
-
248
- IBM-{1144,1145,1146,1147,1148,1149,1153,1154,1155,1156,1157,1158},
249
- <br>
250
- IBM-{1165,1166,4971} <br>
251
- Semitic languages: <br>
252
- IBM-{424,425,12712,16804} <br>
253
- Persian: <br>
254
- IBM-1097 <br>
255
- Thai: <br>
256
- IBM-{838,1160} <br>
257
- Laotian: <br>
258
- IBM-1132 <br>
259
- Vietnamese: <br>
260
- IBM-{1130,1164} <br>
261
- Indic languages: <br>
262
- IBM-1137</p>
263
-
264
- <p style="margin-left:11%; margin-top: 1em">The empty
265
- encoding name &quot;&quot; is equivalent to
266
- &quot;char&quot;: it denotes the locale dependent character
267
- encoding.</p>
268
-
269
- <p style="margin-left:11%; margin-top: 1em">When the string
270
- &quot;//TRANSLIT&quot; is appended to <i>tocode</i>,
271
- transliteration is activated. This means that when a
272
- character cannot be represented in the target character set,
273
- it can be approximated through one or several characters
274
- that look similar to the original character.</p>
275
-
276
- <p style="margin-left:11%; margin-top: 1em">When the string
277
- &quot;//IGNORE&quot; is appended to <i>tocode</i>, invalid
278
- multibyte sequences in the input and characters that cannot
279
- be represented in the target character set will be silently
280
- discarded.</p>
281
-
282
- <p style="margin-left:11%; margin-top: 1em">When the string
283
- &quot;//NON_IDENTICAL_DISCARD&quot; is appended to
284
- <i>tocode</i>, characters that cannot be represented in the
285
- target character set will be silently discarded.</p>
286
-
287
- <p style="margin-left:11%; margin-top: 1em">The resulting
288
- conversion descriptor can be used with <b>iconv</b> any
289
- number of times. It remains valid until deallocated using
290
- <b>iconv_close</b>.</p>
291
-
292
- <p style="margin-left:11%; margin-top: 1em">A conversion
293
- descriptor contains a conversion state. After creation using
294
- <b>iconv_open</b>, the state is in the initial state. Using
295
- <b>iconv</b> modifies the descriptor&rsquo;s conversion
296
- state. (This implies that a conversion descriptor can not be
297
- used in multiple threads simultaneously.) To bring the state
298
- back to the initial state, use <b>iconv</b> with NULL as
299
- <i>inbuf</i> argument.</p>
300
-
301
- <h2>RETURN VALUE
302
- <a name="RETURN VALUE"></a>
303
- </h2>
304
-
305
-
306
- <p style="margin-left:11%; margin-top: 1em">The
307
- <b>iconv_open</b> function returns a freshly allocated
308
- conversion descriptor. In case of error, it sets
309
- <b>errno</b> and returns (iconv_t)(&minus;1).</p>
310
-
311
- <h2>ERRORS
312
- <a name="ERRORS"></a>
313
- </h2>
314
-
315
-
316
- <p style="margin-left:11%; margin-top: 1em">The following
317
- error can occur, among others:</p>
318
-
319
- <table width="100%" border="0" rules="none" frame="void"
320
- cellspacing="0" cellpadding="0">
321
- <tr valign="top" align="left">
322
- <td width="11%"></td>
323
- <td width="9%">
324
-
325
-
326
- <p><b>EINVAL</b></p></td>
327
- <td width="2%"></td>
328
- <td width="78%">
329
-
330
-
331
- <p>The conversion from <i>fromcode</i> to <i>tocode</i> is
332
- not supported by the implementation.</p></td></tr>
333
- </table>
334
-
335
- <h2>CONFORMING TO
336
- <a name="CONFORMING TO"></a>
337
- </h2>
338
-
339
-
340
- <p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
341
-
342
- <h2>SEE ALSO
343
- <a name="SEE ALSO"></a>
344
- </h2>
345
-
346
-
347
-
348
- <p style="margin-left:11%; margin-top: 1em"><b>iconv</b>(3)
349
- <b>iconvctl</b>(3) <b>iconv_close</b>(3)</p>
350
- <hr>
351
- </body>
352
- </html>