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

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 (139) hide show
  1. package/LICENSE +502 -0
  2. package/README.md +47 -0
  3. package/cppjs-package-iconv.podspec +13 -0
  4. package/cppjs.build.js +14 -0
  5. package/cppjs.config.js +18 -0
  6. package/dist/prebuilt/Android-arm64-v8a/include/iconv.h +241 -0
  7. package/dist/prebuilt/Android-arm64-v8a/include/libcharset.h +45 -0
  8. package/dist/prebuilt/Android-arm64-v8a/include/localcharset.h +137 -0
  9. package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.la +41 -0
  10. package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.so +0 -0
  11. package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.la +41 -0
  12. package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.so +0 -0
  13. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.1.html +205 -0
  14. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.3.html +206 -0
  15. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_close.3.html +89 -0
  16. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open.3.html +345 -0
  17. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open_into.3.html +132 -0
  18. package/dist/prebuilt/Android-arm64-v8a/share/doc/iconvctl.3.html +170 -0
  19. package/dist/prebuilt/Android-arm64-v8a/share/man/man1/iconv.1 +108 -0
  20. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv.3 +92 -0
  21. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_close.3 +31 -0
  22. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open.3 +254 -0
  23. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open_into.3 +47 -0
  24. package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconvctl.3 +67 -0
  25. package/dist/prebuilt/CMakeLists.txt +44 -0
  26. package/dist/prebuilt/Emscripten-x86_64/include/iconv.h +241 -0
  27. package/dist/prebuilt/Emscripten-x86_64/include/libcharset.h +45 -0
  28. package/dist/prebuilt/Emscripten-x86_64/include/localcharset.h +137 -0
  29. package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.a +0 -0
  30. package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.la +41 -0
  31. package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.a +0 -0
  32. package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.la +41 -0
  33. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.1.html +205 -0
  34. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.3.html +206 -0
  35. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_close.3.html +89 -0
  36. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open.3.html +345 -0
  37. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open_into.3.html +132 -0
  38. package/dist/prebuilt/Emscripten-x86_64/share/doc/iconvctl.3.html +170 -0
  39. package/dist/prebuilt/Emscripten-x86_64/share/locale/af/LC_MESSAGES/libiconv.mo +0 -0
  40. package/dist/prebuilt/Emscripten-x86_64/share/locale/bg/LC_MESSAGES/libiconv.mo +0 -0
  41. package/dist/prebuilt/Emscripten-x86_64/share/locale/ca/LC_MESSAGES/libiconv.mo +0 -0
  42. package/dist/prebuilt/Emscripten-x86_64/share/locale/cs/LC_MESSAGES/libiconv.mo +0 -0
  43. package/dist/prebuilt/Emscripten-x86_64/share/locale/da/LC_MESSAGES/libiconv.mo +0 -0
  44. package/dist/prebuilt/Emscripten-x86_64/share/locale/de/LC_MESSAGES/libiconv.mo +0 -0
  45. package/dist/prebuilt/Emscripten-x86_64/share/locale/el/LC_MESSAGES/libiconv.mo +0 -0
  46. package/dist/prebuilt/Emscripten-x86_64/share/locale/eo/LC_MESSAGES/libiconv.mo +0 -0
  47. package/dist/prebuilt/Emscripten-x86_64/share/locale/es/LC_MESSAGES/libiconv.mo +0 -0
  48. package/dist/prebuilt/Emscripten-x86_64/share/locale/et/LC_MESSAGES/libiconv.mo +0 -0
  49. package/dist/prebuilt/Emscripten-x86_64/share/locale/fi/LC_MESSAGES/libiconv.mo +0 -0
  50. package/dist/prebuilt/Emscripten-x86_64/share/locale/fr/LC_MESSAGES/libiconv.mo +0 -0
  51. package/dist/prebuilt/Emscripten-x86_64/share/locale/ga/LC_MESSAGES/libiconv.mo +0 -0
  52. package/dist/prebuilt/Emscripten-x86_64/share/locale/gl/LC_MESSAGES/libiconv.mo +0 -0
  53. package/dist/prebuilt/Emscripten-x86_64/share/locale/hr/LC_MESSAGES/libiconv.mo +0 -0
  54. package/dist/prebuilt/Emscripten-x86_64/share/locale/hu/LC_MESSAGES/libiconv.mo +0 -0
  55. package/dist/prebuilt/Emscripten-x86_64/share/locale/id/LC_MESSAGES/libiconv.mo +0 -0
  56. package/dist/prebuilt/Emscripten-x86_64/share/locale/it/LC_MESSAGES/libiconv.mo +0 -0
  57. package/dist/prebuilt/Emscripten-x86_64/share/locale/ja/LC_MESSAGES/libiconv.mo +0 -0
  58. package/dist/prebuilt/Emscripten-x86_64/share/locale/ko/LC_MESSAGES/libiconv.mo +0 -0
  59. package/dist/prebuilt/Emscripten-x86_64/share/locale/lt/LC_MESSAGES/libiconv.mo +0 -0
  60. package/dist/prebuilt/Emscripten-x86_64/share/locale/nl/LC_MESSAGES/libiconv.mo +0 -0
  61. package/dist/prebuilt/Emscripten-x86_64/share/locale/pl/LC_MESSAGES/libiconv.mo +0 -0
  62. package/dist/prebuilt/Emscripten-x86_64/share/locale/pt_BR/LC_MESSAGES/libiconv.mo +0 -0
  63. package/dist/prebuilt/Emscripten-x86_64/share/locale/rm/LC_MESSAGES/libiconv.mo +0 -0
  64. package/dist/prebuilt/Emscripten-x86_64/share/locale/ro/LC_MESSAGES/libiconv.mo +0 -0
  65. package/dist/prebuilt/Emscripten-x86_64/share/locale/ru/LC_MESSAGES/libiconv.mo +0 -0
  66. package/dist/prebuilt/Emscripten-x86_64/share/locale/sk/LC_MESSAGES/libiconv.mo +0 -0
  67. package/dist/prebuilt/Emscripten-x86_64/share/locale/sl/LC_MESSAGES/libiconv.mo +0 -0
  68. package/dist/prebuilt/Emscripten-x86_64/share/locale/sq/LC_MESSAGES/libiconv.mo +0 -0
  69. package/dist/prebuilt/Emscripten-x86_64/share/locale/sr/LC_MESSAGES/libiconv.mo +0 -0
  70. package/dist/prebuilt/Emscripten-x86_64/share/locale/sv/LC_MESSAGES/libiconv.mo +0 -0
  71. package/dist/prebuilt/Emscripten-x86_64/share/locale/tr/LC_MESSAGES/libiconv.mo +0 -0
  72. package/dist/prebuilt/Emscripten-x86_64/share/locale/uk/LC_MESSAGES/libiconv.mo +0 -0
  73. package/dist/prebuilt/Emscripten-x86_64/share/locale/vi/LC_MESSAGES/libiconv.mo +0 -0
  74. package/dist/prebuilt/Emscripten-x86_64/share/locale/wa/LC_MESSAGES/libiconv.mo +0 -0
  75. package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_CN/LC_MESSAGES/libiconv.mo +0 -0
  76. package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_TW/LC_MESSAGES/libiconv.mo +0 -0
  77. package/dist/prebuilt/Emscripten-x86_64/share/man/man1/iconv.1 +108 -0
  78. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv.3 +92 -0
  79. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_close.3 +31 -0
  80. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open.3 +254 -0
  81. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open_into.3 +47 -0
  82. package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconvctl.3 +67 -0
  83. package/dist/prebuilt/charset.xcframework/Info.plist +50 -0
  84. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/iconv.h +241 -0
  85. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/libcharset.h +45 -0
  86. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/localcharset.h +137 -0
  87. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/libcharset.a +0 -0
  88. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +241 -0
  89. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +45 -0
  90. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +137 -0
  91. package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/libcharset.a +0 -0
  92. package/dist/prebuilt/iOS-iphoneos/include/iconv.h +241 -0
  93. package/dist/prebuilt/iOS-iphoneos/include/libcharset.h +45 -0
  94. package/dist/prebuilt/iOS-iphoneos/include/localcharset.h +137 -0
  95. package/dist/prebuilt/iOS-iphoneos/lib/libcharset.a +0 -0
  96. package/dist/prebuilt/iOS-iphoneos/lib/libcharset.la +41 -0
  97. package/dist/prebuilt/iOS-iphoneos/lib/libiconv.a +0 -0
  98. package/dist/prebuilt/iOS-iphoneos/lib/libiconv.la +41 -0
  99. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.1.html +205 -0
  100. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.3.html +206 -0
  101. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_close.3.html +89 -0
  102. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open.3.html +345 -0
  103. package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open_into.3.html +132 -0
  104. package/dist/prebuilt/iOS-iphoneos/share/doc/iconvctl.3.html +170 -0
  105. package/dist/prebuilt/iOS-iphoneos/share/man/man1/iconv.1 +108 -0
  106. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv.3 +92 -0
  107. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_close.3 +31 -0
  108. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open.3 +254 -0
  109. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open_into.3 +47 -0
  110. package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconvctl.3 +67 -0
  111. package/dist/prebuilt/iOS-iphonesimulator/include/iconv.h +241 -0
  112. package/dist/prebuilt/iOS-iphonesimulator/include/libcharset.h +45 -0
  113. package/dist/prebuilt/iOS-iphonesimulator/include/localcharset.h +137 -0
  114. package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.a +0 -0
  115. package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.la +41 -0
  116. package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.a +0 -0
  117. package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.la +41 -0
  118. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.1.html +205 -0
  119. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.3.html +206 -0
  120. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_close.3.html +89 -0
  121. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open.3.html +345 -0
  122. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open_into.3.html +132 -0
  123. package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconvctl.3.html +170 -0
  124. package/dist/prebuilt/iOS-iphonesimulator/share/man/man1/iconv.1 +108 -0
  125. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv.3 +92 -0
  126. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_close.3 +31 -0
  127. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open.3 +254 -0
  128. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open_into.3 +47 -0
  129. package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconvctl.3 +67 -0
  130. package/dist/prebuilt/iconv.xcframework/Info.plist +50 -0
  131. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/iconv.h +241 -0
  132. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/libcharset.h +45 -0
  133. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/localcharset.h +137 -0
  134. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/libiconv.a +0 -0
  135. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +241 -0
  136. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +45 -0
  137. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +137 -0
  138. package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/libiconv.a +0 -0
  139. package/package.json +28 -0
@@ -0,0 +1,170 @@
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>ICONVCTL</title>
16
+
17
+ </head>
18
+ <body>
19
+
20
+ <h1 align="center">ICONVCTL</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="#REQUEST VALUES">REQUEST VALUES</a><br>
26
+ <a href="#RETURN VALUE">RETURN VALUE</a><br>
27
+ <a href="#ERRORS">ERRORS</a><br>
28
+ <a href="#CONFORMING TO">CONFORMING TO</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">iconvctl
40
+ &minus; control iconv behavior</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>int iconvctl
51
+ (iconv_t</b> <i>cd</i> <b>, int</b> <i>request</i><b>, void
52
+ *</b> <i>argument</i><b>);</b></p>
53
+
54
+ <h2>DESCRIPTION
55
+ <a name="DESCRIPTION"></a>
56
+ </h2>
57
+
58
+
59
+ <p style="margin-left:11%; margin-top: 1em">The argument
60
+ <i>cd</i> must be a conversion descriptor created using the
61
+ function <b>iconv_open</b>.</p>
62
+
63
+
64
+ <p style="margin-left:11%; margin-top: 1em"><b>iconvctl</b>
65
+ queries or adjusts the behavior of the <b>iconv</b>
66
+ function, when invoked with the specified conversion
67
+ descriptor, depending on the request value.</p>
68
+
69
+ <h2>REQUEST VALUES
70
+ <a name="REQUEST VALUES"></a>
71
+ </h2>
72
+
73
+
74
+ <p style="margin-left:11%; margin-top: 1em">The following
75
+ are permissible values for the <i>request</i> parameter.
76
+ <b><br>
77
+ ICONV_TRIVIALP</b></p>
78
+
79
+ <p style="margin-left:22%;"><i>argument</i> should be an
80
+ <b>int *</b> which will receive 1 if the conversion is
81
+ trivial, or 0 otherwise.</p>
82
+
83
+
84
+ <p style="margin-left:11%;"><b>ICONV_GET_TRANSLITERATE</b></p>
85
+
86
+ <p style="margin-left:22%;"><i>argument</i> should be an
87
+ <b>int *</b> which will receive 1 if transliteration is
88
+ enabled in the conversion, or 0 otherwise.</p>
89
+
90
+
91
+ <p style="margin-left:11%;"><b>ICONV_SET_TRANSLITERATE</b></p>
92
+
93
+ <p style="margin-left:22%;"><i>argument</i> should be a
94
+ <b>const int *</b>, pointing to an <b>int</b> value. A
95
+ non-zero value is used to enable transliteration in the
96
+ conversion. A zero value disables it.</p>
97
+
98
+
99
+ <p style="margin-left:11%;"><b>ICONV_GET_DISCARD_ILSEQ</b></p>
100
+
101
+ <p style="margin-left:22%;"><i>argument</i> should be an
102
+ <b>int *</b> which will receive 1 if &quot;illegal sequence
103
+ discard and continue&quot; is enabled in the conversion, or
104
+ 0 otherwise.</p>
105
+
106
+
107
+ <p style="margin-left:11%;"><b>ICONV_SET_DISCARD_ILSEQ</b></p>
108
+
109
+ <p style="margin-left:22%;"><i>argument</i> should be a
110
+ <b>const int *</b>, pointing to an <b>int</b> value. A
111
+ non-zero value is used to enable &quot;illegal sequence
112
+ discard and continue&quot; in the conversion. A zero value
113
+ disables it.</p>
114
+
115
+ <h2>RETURN VALUE
116
+ <a name="RETURN VALUE"></a>
117
+ </h2>
118
+
119
+
120
+ <p style="margin-left:11%; margin-top: 1em">The
121
+ <b>iconvctl</b> function returns 0 if it succeeds. In case
122
+ of error, it sets <b>errno</b> and returns &minus;1.</p>
123
+
124
+ <h2>ERRORS
125
+ <a name="ERRORS"></a>
126
+ </h2>
127
+
128
+
129
+ <p style="margin-left:11%; margin-top: 1em">The following
130
+ errors can occur, among others:</p>
131
+
132
+ <table width="100%" border="0" rules="none" frame="void"
133
+ cellspacing="0" cellpadding="0">
134
+ <tr valign="top" align="left">
135
+ <td width="11%"></td>
136
+ <td width="9%">
137
+
138
+
139
+ <p><b>EINVAL</b></p></td>
140
+ <td width="2%"></td>
141
+ <td width="35%">
142
+
143
+
144
+ <p>The request is invalid.</p></td>
145
+ <td width="43%">
146
+ </td></tr>
147
+ </table>
148
+
149
+ <h2>CONFORMING TO
150
+ <a name="CONFORMING TO"></a>
151
+ </h2>
152
+
153
+
154
+ <p style="margin-left:11%; margin-top: 1em">This function
155
+ is implemented only in GNU libiconv and not in other
156
+ <b>iconv</b> implementations. It is not backed by a
157
+ standard. You can test for its presence through
158
+ <b>(_LIBICONV_VERSION &gt;= 0x0108)</b>.</p>
159
+
160
+ <h2>SEE ALSO
161
+ <a name="SEE ALSO"></a>
162
+ </h2>
163
+
164
+
165
+
166
+ <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3)
167
+ <b>iconv</b>(3)</p>
168
+ <hr>
169
+ </body>
170
+ </html>
@@ -0,0 +1,108 @@
1
+ .\" Copyright (c) Free Software Foundation, Inc.
2
+ .\"
3
+ .\" This is free documentation; you can redistribute it and/or
4
+ .\" modify it under the terms of the GNU General Public License as
5
+ .\" published by the Free Software Foundation; either version 3 of
6
+ .\" the License, or (at your option) any later version.
7
+ .\"
8
+ .\" References consulted:
9
+ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
10
+ .\" POSIX 2001 draft6
11
+ .\"
12
+ .TH ICONV 1 "March 31, 2007" "GNU" "Linux Programmer's Manual"
13
+ .SH NAME
14
+ iconv \- character set conversion
15
+ .SH SYNOPSIS
16
+ .nf
17
+ iconv [\fIOPTION\fP...] [\fB\-f\fP \fIencoding\fP] [\fB\-t\fP \fIencoding\fP] [\fIinputfile\fP ...]
18
+ iconv \fB\-l\fP
19
+ .fi
20
+ .SH DESCRIPTION
21
+ The \fBiconv\fP program converts text from one encoding to another encoding.
22
+ More precisely, it converts \fBfrom\fP the encoding given for the \fB\-f\fP
23
+ option \fBto\fP the encoding given for the \fB\-t\fP option. Either of these
24
+ encodings defaults to the encoding of the current locale. All the
25
+ \fIinputfile\fPs are read and converted in turn; if no \fIinputfile\fP is
26
+ given, the standard input is used. The converted text is printed to standard
27
+ output.
28
+ .PP
29
+ The encodings permitted are system dependent. For the libiconv implementation,
30
+ they are listed in the iconv_open(3) manual page.
31
+ .PP
32
+ Options controlling the input and output format:
33
+ .TP
34
+ \fB\-f\fP \fIencoding\fP, \fB\-\-from\-code=\fP\fIencoding\fP
35
+ Specifies the encoding of the input.
36
+ .TP
37
+ \fB\-t\fP \fIencoding\fP, \fB\-\-to\-code=\fP\fIencoding\fP
38
+ Specifies the encoding of the output.
39
+ .PP
40
+ Options controlling conversion problems:
41
+ .TP
42
+ \fB\-c\fP
43
+ When this option is given, characters that cannot be converted are silently
44
+ discarded, instead of leading to a conversion error.
45
+ .TP
46
+ \fB\-\-unicode\-subst=\fP\fIformatstring\fP
47
+ When this option is given, Unicode characters that cannot be represented in
48
+ the target encoding are replaced with a placeholder string that is constructed
49
+ from the given \fIformatstring\fP, applied to the Unicode code point. The
50
+ \fIformatstring\fP must be a format string in the same format as for the
51
+ .I printf
52
+ command or the
53
+ .I printf()
54
+ function, taking either no argument or exactly one unsigned integer argument.
55
+ .TP
56
+ \fB\-\-byte\-subst=\fP\fIformatstring\fP
57
+ When this option is given, bytes in the input that are not valid in the source
58
+ encoding are replaced with a placeholder string that is constructed from the
59
+ given \fIformatstring\fP, applied to the byte's value. The \fIformatstring\fP
60
+ must be a format string in the same format as for the
61
+ .I printf
62
+ command or the
63
+ .I printf()
64
+ function, taking either no argument or exactly one unsigned integer argument.
65
+ .TP
66
+ \fB\-\-widechar\-subst=\fP\fIformatstring\fP
67
+ When this option is given, wide characters in the input that are not valid in
68
+ the source encoding are replaced with a placeholder string that is constructed
69
+ from the given \fIformatstring\fP, applied to the byte's value. The
70
+ \fIformatstring\fP must be a format string in the same format as for the
71
+ .I printf
72
+ command or the
73
+ .I printf()
74
+ function, taking either no argument or exactly one unsigned integer argument.
75
+ .PP
76
+ Options controlling error output:
77
+ .TP
78
+ \fB\-s\fP, \fB\-\-silent\fP
79
+ When this option is given, error messages about invalid or unconvertible
80
+ characters are omitted, but the actual converted text is unaffected.
81
+ .PP
82
+ The \fBiconv \-l\fP or \fBiconv \-\-list\fP command lists the names of the
83
+ supported encodings, in a system dependent format. For the libiconv
84
+ implementation, the names are printed in upper case, separated by whitespace,
85
+ and alias names of an encoding are listed on the same line as the encoding
86
+ itself.
87
+ .SH EXAMPLES
88
+ .TP
89
+ \fBiconv \-f ISO\-8859\-1 \-t UTF\-8\fP
90
+ converts input from the old West-European encoding ISO\-8859\-1 to Unicode.
91
+ .PP
92
+ .nf
93
+ \fBiconv \-f KOI8\-R \-\-byte\-subst="<0x%x>"\fP
94
+ \fB \-\-unicode\-subst="<U+%04X>"\fP
95
+ .fi
96
+ .RS
97
+ converts input from the old Russian encoding KOI8\-R to the locale encoding,
98
+ substituting an angle bracket notation with hexadecimal numbers for invalid
99
+ bytes and for valid but unconvertible characters.
100
+ .RE
101
+ .TP
102
+ \fBiconv \-\-list\fP
103
+ lists the supported encodings.
104
+ .SH "CONFORMING TO"
105
+ POSIX:2001
106
+ .SH "SEE ALSO"
107
+ .BR iconv_open (3),
108
+ .BR locale (7)
@@ -0,0 +1,92 @@
1
+ .\" Copyright (c) Free Software Foundation, Inc.
2
+ .\"
3
+ .\" This is free documentation; you can redistribute it and/or
4
+ .\" modify it under the terms of the GNU General Public License as
5
+ .\" published by the Free Software Foundation; either version 3 of
6
+ .\" the License, or (at your option) any later version.
7
+ .\"
8
+ .\" References consulted:
9
+ .\" GNU glibc-2 source code and manual
10
+ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
11
+ .\"
12
+ .TH ICONV 3 "September 7, 2008" "GNU" "Linux Programmer's Manual"
13
+ .SH NAME
14
+ iconv \- perform character set conversion
15
+ .SH SYNOPSIS
16
+ .nf
17
+ .B #include <iconv.h>
18
+ .sp
19
+ .BI "size_t iconv (iconv_t " cd ,
20
+ .BI " const char* * " inbuf ", size_t * "inbytesleft ,
21
+ .BI " char* * " outbuf ", size_t * "outbytesleft );
22
+ .fi
23
+ .SH DESCRIPTION
24
+ The argument \fIcd\fP must be a conversion descriptor created using the
25
+ function \fBiconv_open\fP.
26
+ .PP
27
+ The main case is when \fIinbuf\fP is not NULL and \fI*inbuf\fP is not NULL.
28
+ In this case, the \fBiconv\fP function converts the multibyte sequence
29
+ starting at \fI*inbuf\fP to a multibyte sequence starting at \fI*outbuf\fP.
30
+ At most \fI*inbytesleft\fP bytes, starting at \fI*inbuf\fP, will be read.
31
+ At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
32
+ .PP
33
+ The \fBiconv\fP function converts one multibyte character at a time, and for
34
+ each character conversion it increments \fI*inbuf\fP and decrements
35
+ \fI*inbytesleft\fP by the number of converted input bytes, it increments
36
+ \fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of converted
37
+ output bytes, and it updates the conversion state contained in \fIcd\fP.
38
+ If the character encoding of the input is stateful, the \fBiconv\fP function
39
+ can also convert a sequence of input bytes to an update of the conversion state
40
+ without producing any output bytes; such input is called a \fIshift sequence\fP.
41
+ The conversion can stop for four reasons:
42
+ .PP
43
+ 1. An invalid multibyte sequence is encountered in the input. In this case
44
+ it sets \fBerrno\fP to \fBEILSEQ\fP and returns (size_t)(\-1). \fI*inbuf\fP
45
+ is left pointing to the beginning of the invalid multibyte sequence.
46
+ .PP
47
+ 2. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
48
+ has gone down to 0. In this case \fBiconv\fP returns the number of
49
+ non-reversible conversions performed during this call.
50
+ .PP
51
+ 3. An incomplete multibyte sequence is encountered in the input, and the
52
+ input byte sequence terminates after it. In this case it sets \fBerrno\fP to
53
+ \fBEINVAL\fP and returns (size_t)(\-1). \fI*inbuf\fP is left pointing to the
54
+ beginning of the incomplete multibyte sequence.
55
+ .PP
56
+ 4. The output buffer has no more room for the next converted character. In
57
+ this case it sets \fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1).
58
+ .PP
59
+ A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
60
+ \fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL. In this case, the
61
+ \fBiconv\fP function attempts to set \fIcd\fP's conversion state to the
62
+ initial state and store a corresponding shift sequence at \fI*outbuf\fP.
63
+ At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
64
+ If the output buffer has no more room for this reset sequence, it sets
65
+ \fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1). Otherwise it increments
66
+ \fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
67
+ written.
68
+ .PP
69
+ A third case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, and
70
+ \fIoutbuf\fP is NULL or \fI*outbuf\fP is NULL. In this case, the \fBiconv\fP
71
+ function sets \fIcd\fP's conversion state to the initial state.
72
+ .SH "RETURN VALUE"
73
+ The \fBiconv\fP function returns the number of characters converted in a
74
+ non-reversible way during this call; reversible conversions are not counted.
75
+ In case of error, it sets \fBerrno\fP and returns (size_t)(\-1).
76
+ .SH ERRORS
77
+ The following errors can occur, among others:
78
+ .TP
79
+ .B E2BIG
80
+ There is not sufficient room at \fI*outbuf\fP.
81
+ .TP
82
+ .B EILSEQ
83
+ An invalid multibyte sequence has been encountered in the input.
84
+ .TP
85
+ .B EINVAL
86
+ An incomplete multibyte sequence has been encountered in the input.
87
+ .SH "CONFORMING TO"
88
+ POSIX:2001
89
+ .SH "SEE ALSO"
90
+ .BR iconv_open (3),
91
+ .BR iconvctl (3)
92
+ .BR iconv_close (3)
@@ -0,0 +1,31 @@
1
+ .\" Copyright (c) Free Software Foundation, Inc.
2
+ .\"
3
+ .\" This is free documentation; you can redistribute it and/or
4
+ .\" modify it under the terms of the GNU General Public License as
5
+ .\" published by the Free Software Foundation; either version 3 of
6
+ .\" the License, or (at your option) any later version.
7
+ .\"
8
+ .\" References consulted:
9
+ .\" GNU glibc-2 source code and manual
10
+ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
11
+ .\"
12
+ .TH ICONV_CLOSE 3 "March 31, 2007" "GNU" "Linux Programmer's Manual"
13
+ .SH NAME
14
+ iconv_close \- deallocate descriptor for character set conversion
15
+ .SH SYNOPSIS
16
+ .nf
17
+ .B #include <iconv.h>
18
+ .sp
19
+ .BI "int iconv_close (iconv_t " cd );
20
+ .fi
21
+ .SH DESCRIPTION
22
+ The \fBiconv_close\fP function deallocates a conversion descriptor \fIcd\fP
23
+ previously allocated using \fBiconv_open\fP.
24
+ .SH "RETURN VALUE"
25
+ When successful, the \fBiconv_close\fP function returns 0. In case of error,
26
+ it sets \fBerrno\fP and returns \-1.
27
+ .SH "CONFORMING TO"
28
+ POSIX:2001
29
+ .SH "SEE ALSO"
30
+ .BR iconv_open (3)
31
+ .BR iconv (3)
@@ -0,0 +1,254 @@
1
+ .\" Copyright (c) Free Software Foundation, Inc.
2
+ .\"
3
+ .\" This is free documentation; you can redistribute it and/or
4
+ .\" modify it under the terms of the GNU General Public License as
5
+ .\" published by the Free Software Foundation; either version 3 of
6
+ .\" the License, or (at your option) any later version.
7
+ .\"
8
+ .\" References consulted:
9
+ .\" GNU glibc-2 source code and manual
10
+ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
11
+ .\"
12
+ .TH ICONV_OPEN 3 "January 23, 2022" "GNU" "Linux Programmer's Manual"
13
+ .SH NAME
14
+ iconv_open \- allocate descriptor for character set conversion
15
+ .SH SYNOPSIS
16
+ .nf
17
+ .B #include <iconv.h>
18
+ .sp
19
+ .BI "iconv_t iconv_open (const char* " tocode ", const char* " fromcode );
20
+ .fi
21
+ .SH DESCRIPTION
22
+ The \fBiconv_open\fP function allocates a conversion descriptor suitable
23
+ for converting byte sequences from character encoding \fIfromcode\fP to
24
+ character encoding \fItocode\fP.
25
+ .PP
26
+ The values permitted for \fIfromcode\fP and \fItocode\fP and the supported
27
+ combinations are system dependent. For the libiconv library, the following
28
+ encodings are supported, in all combinations.
29
+ .TP
30
+ European languages
31
+ .nf
32
+ .fi
33
+ ASCII, ISO\-8859\-{1,2,3,4,5,7,9,10,13,14,15,16},
34
+ KOI8\-R, KOI8\-U, KOI8\-RU,
35
+ CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
36
+ Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
37
+ Mac{Cyrillic,Ukraine,Greek,Turkish},
38
+ Macintosh
39
+ .TP
40
+ Semitic languages
41
+ .nf
42
+ .fi
43
+ ISO\-8859\-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
44
+ .TP
45
+ Japanese
46
+ .nf
47
+ .fi
48
+ EUC\-JP, SHIFT_JIS, CP932, ISO\-2022\-JP, ISO\-2022\-JP\-2, ISO\-2022\-JP\-1,
49
+ ISO-2022\-JP\-MS
50
+ .TP
51
+ Chinese
52
+ .nf
53
+ .fi
54
+ EUC\-CN, HZ, GBK, CP936, GB18030, EUC\-TW, BIG5, CP950, BIG5\-HKSCS,
55
+ BIG5\-HKSCS:2004, BIG5\-HKSCS:2001, BIG5\-HKSCS:1999, ISO\-2022\-CN,
56
+ ISO\-2022\-CN\-EXT
57
+ .TP
58
+ Korean
59
+ .nf
60
+ .fi
61
+ EUC\-KR, CP949, ISO\-2022\-KR, JOHAB
62
+ .TP
63
+ Armenian
64
+ .nf
65
+ .fi
66
+ ARMSCII\-8
67
+ .TP
68
+ Georgian
69
+ .nf
70
+ .fi
71
+ Georgian\-Academy, Georgian\-PS
72
+ .TP
73
+ Tajik
74
+ .nf
75
+ .fi
76
+ KOI8\-T
77
+ .TP
78
+ Kazakh
79
+ .nf
80
+ .fi
81
+ PT154, RK1048
82
+ .TP
83
+ Thai
84
+ .nf
85
+ .fi
86
+ TIS\-620, CP874, MacThai
87
+ .TP
88
+ Laotian
89
+ .nf
90
+ .fi
91
+ MuleLao\-1, CP1133
92
+ .TP
93
+ Vietnamese
94
+ .nf
95
+ .fi
96
+ VISCII, TCVN, CP1258
97
+ .TP
98
+ Platform specifics
99
+ .nf
100
+ .fi
101
+ HP\-ROMAN8, NEXTSTEP
102
+ .TP
103
+ Full Unicode
104
+ .nf
105
+ .fi
106
+ UTF\-8
107
+ .nf
108
+ .fi
109
+ UCS\-2, UCS\-2BE, UCS\-2LE
110
+ .nf
111
+ .fi
112
+ UCS\-4, UCS\-4BE, UCS\-4LE
113
+ .nf
114
+ .fi
115
+ UTF\-16, UTF\-16BE, UTF\-16LE
116
+ .nf
117
+ .fi
118
+ UTF\-32, UTF\-32BE, UTF\-32LE
119
+ .nf
120
+ .fi
121
+ UTF\-7
122
+ .nf
123
+ .fi
124
+ C99, JAVA
125
+ .TP
126
+ Full Unicode, in terms of \fBuint16_t\fP or \fBuint32_t\fP
127
+ (with machine dependent endianness and alignment)
128
+ .nf
129
+ .fi
130
+ UCS\-2\-INTERNAL, UCS\-4\-INTERNAL
131
+ .TP
132
+ Locale dependent, in terms of \fBchar\fP or \fBwchar_t\fP
133
+ (with machine dependent endianness and alignment, and with semantics
134
+ depending on the OS and the current LC_CTYPE locale facet)
135
+ .nf
136
+ .fi
137
+ char, wchar_t
138
+ .PP
139
+ When configured with the option \fB\-\-enable\-extra\-encodings\fP, it also
140
+ provides support for a few extra encodings:
141
+ .TP
142
+ European languages
143
+ .nf
144
+ CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
145
+ .fi
146
+ .TP
147
+ Semitic languages
148
+ .nf
149
+ .fi
150
+ CP864
151
+ .TP
152
+ Japanese
153
+ .nf
154
+ .fi
155
+ EUC\-JISX0213, Shift_JISX0213, ISO\-2022\-JP\-3
156
+ .TP
157
+ Chinese
158
+ .nf
159
+ .fi
160
+ BIG5\-2003 (experimental)
161
+ .TP
162
+ Turkmen
163
+ .nf
164
+ .fi
165
+ TDS565
166
+ .TP
167
+ Platform specifics
168
+ .nf
169
+ .fi
170
+ ATARIST, RISCOS\-LATIN1
171
+ .PP
172
+ .TP
173
+ EBCDIC compatible (not ASCII compatible, very rarely used)
174
+ .nf
175
+ .fi
176
+ European languages:
177
+ .nf
178
+ .fi
179
+ IBM-{037,273,277,278,280,282,284,285,297,423,500,870,871,875,880},
180
+ IBM-{905,924,1025,1026,1047,1112,1122,1123,1140,1141,1142,1143},
181
+ IBM-{1144,1145,1146,1147,1148,1149,1153,1154,1155,1156,1157,1158},
182
+ IBM-{1165,1166,4971}
183
+ .nf
184
+ .fi
185
+ Semitic languages:
186
+ .nf
187
+ .fi
188
+ IBM-{424,425,12712,16804}
189
+ .nf
190
+ .fi
191
+ Persian:
192
+ .nf
193
+ .fi
194
+ IBM-1097
195
+ .nf
196
+ .fi
197
+ Thai:
198
+ .nf
199
+ .fi
200
+ IBM-{838,1160}
201
+ .nf
202
+ .fi
203
+ Laotian:
204
+ .nf
205
+ .fi
206
+ IBM-1132
207
+ .nf
208
+ .fi
209
+ Vietnamese:
210
+ .nf
211
+ .fi
212
+ IBM-{1130,1164}
213
+ .nf
214
+ .fi
215
+ Indic languages:
216
+ .nf
217
+ .fi
218
+ IBM-1137
219
+ .PP
220
+ The empty encoding name "" is equivalent to "char": it denotes the
221
+ locale dependent character encoding.
222
+ .PP
223
+ When the string "//TRANSLIT" is appended to \fItocode\fP, transliteration
224
+ is activated. This means that when a character cannot be represented in the
225
+ target character set, it can be approximated through one or several characters
226
+ that look similar to the original character.
227
+ .PP
228
+ When the string "//IGNORE" is appended to \fItocode\fP, characters that
229
+ cannot be represented in the target character set will be silently discarded.
230
+ .PP
231
+ The resulting conversion descriptor can be used with \fBiconv\fP any number
232
+ of times. It remains valid until deallocated using \fBiconv_close\fP.
233
+ .PP
234
+ A conversion descriptor contains a conversion state. After creation using
235
+ \fBiconv_open\fP, the state is in the initial state. Using \fBiconv\fP
236
+ modifies the descriptor's conversion state. (This implies that a conversion
237
+ descriptor can not be used in multiple threads simultaneously.) To bring the
238
+ state back to the initial state, use \fBiconv\fP with NULL as \fIinbuf\fP
239
+ argument.
240
+ .SH "RETURN VALUE"
241
+ The \fBiconv_open\fP function returns a freshly allocated conversion
242
+ descriptor. In case of error, it sets \fBerrno\fP and returns (iconv_t)(\-1).
243
+ .SH ERRORS
244
+ The following error can occur, among others:
245
+ .TP
246
+ .B EINVAL
247
+ The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
248
+ implementation.
249
+ .SH "CONFORMING TO"
250
+ POSIX:2001
251
+ .SH "SEE ALSO"
252
+ .BR iconv (3)
253
+ .BR iconvctl (3)
254
+ .BR iconv_close (3)
@@ -0,0 +1,47 @@
1
+ .\" Copyright (c) Free Software Foundation, Inc.
2
+ .\"
3
+ .\" This is free documentation; you can redistribute it and/or
4
+ .\" modify it under the terms of the GNU General Public License as
5
+ .\" published by the Free Software Foundation; either version 3 of
6
+ .\" the License, or (at your option) any later version.
7
+ .\"
8
+ .\" References consulted:
9
+ .\" iconv.h
10
+ .\"
11
+ .TH ICONV_OPEN_INTO 3 "September 21, 2008" "GNU" "Linux Programmer's Manual"
12
+ .SH NAME
13
+ iconv_open_into \- initialize descriptor for character set conversion
14
+ .SH SYNOPSIS
15
+ .nf
16
+ .B #include <iconv.h>
17
+ .sp
18
+ .BI "int iconv_open_into (const char* " tocode ", const char* " fromcode ","
19
+ .BI " iconv_allocation_t* " resultp );
20
+ .fi
21
+ .SH DESCRIPTION
22
+ The \fBiconv_open_into\fP function initializes a conversion descriptor suitable
23
+ for converting byte sequences from character encoding \fIfromcode\fP to
24
+ character encoding \fItocode\fP. The conversion descriptor is stored in the
25
+ memory pointed to by \fIresultp\fP.
26
+ .PP
27
+ The values permitted for \fIfromcode\fP and \fItocode\fP are the same as for
28
+ the function \fBiconv_open\fP.
29
+ .PP
30
+ After a successful return from this function, \fIresultp\fP can be be used
31
+ as an \fBiconv_t\fP object with the \fBiconv\fP function.
32
+ .SH "RETURN VALUE"
33
+ The \fBiconv_open_into\fP function fills \fB*\fP\fIresultp\fP and returns 0 if
34
+ it succeeds. In case of error, it sets \fBerrno\fP and returns \-1.
35
+ .SH ERRORS
36
+ The following error can occur, among others:
37
+ .TP
38
+ .B EINVAL
39
+ The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
40
+ implementation.
41
+ .SH "CONFORMING TO"
42
+ This function is implemented only in GNU libiconv and not in other \fBiconv\fP
43
+ implementations. It is not backed by a standard. You can test for its presence
44
+ through \fB(_LIBICONV_VERSION >= 0x010D)\fP.
45
+ .SH "SEE ALSO"
46
+ .BR iconv_open (3)
47
+ .BR iconv (3)