@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.
- package/LICENSE +502 -0
- package/README.md +47 -0
- package/cppjs-package-iconv.podspec +13 -0
- package/cppjs.build.js +14 -0
- package/cppjs.config.js +18 -0
- package/dist/prebuilt/Android-arm64-v8a/include/iconv.h +241 -0
- package/dist/prebuilt/Android-arm64-v8a/include/libcharset.h +45 -0
- package/dist/prebuilt/Android-arm64-v8a/include/localcharset.h +137 -0
- package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.la +41 -0
- package/dist/prebuilt/Android-arm64-v8a/lib/libcharset.so +0 -0
- package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.la +41 -0
- package/dist/prebuilt/Android-arm64-v8a/lib/libiconv.so +0 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.1.html +205 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv.3.html +206 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_close.3.html +89 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open.3.html +345 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconv_open_into.3.html +132 -0
- package/dist/prebuilt/Android-arm64-v8a/share/doc/iconvctl.3.html +170 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man1/iconv.1 +108 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv.3 +92 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_close.3 +31 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open.3 +254 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconv_open_into.3 +47 -0
- package/dist/prebuilt/Android-arm64-v8a/share/man/man3/iconvctl.3 +67 -0
- package/dist/prebuilt/CMakeLists.txt +44 -0
- package/dist/prebuilt/Emscripten-x86_64/include/iconv.h +241 -0
- package/dist/prebuilt/Emscripten-x86_64/include/libcharset.h +45 -0
- package/dist/prebuilt/Emscripten-x86_64/include/localcharset.h +137 -0
- package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.a +0 -0
- package/dist/prebuilt/Emscripten-x86_64/lib/libcharset.la +41 -0
- package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.a +0 -0
- package/dist/prebuilt/Emscripten-x86_64/lib/libiconv.la +41 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.1.html +205 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.3.html +206 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_close.3.html +89 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open.3.html +345 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open_into.3.html +132 -0
- package/dist/prebuilt/Emscripten-x86_64/share/doc/iconvctl.3.html +170 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/af/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/bg/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ca/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/cs/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/da/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/de/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/el/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/eo/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/es/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/et/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/fi/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/fr/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ga/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/gl/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/hr/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/hu/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/id/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/it/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ja/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ko/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/lt/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/nl/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/pl/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/pt_BR/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/rm/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ro/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/ru/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/sk/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/sl/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/sq/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/sr/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/sv/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/tr/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/uk/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/vi/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/wa/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_CN/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/locale/zh_TW/LC_MESSAGES/libiconv.mo +0 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man1/iconv.1 +108 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv.3 +92 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_close.3 +31 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open.3 +254 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open_into.3 +47 -0
- package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconvctl.3 +67 -0
- package/dist/prebuilt/charset.xcframework/Info.plist +50 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/iconv.h +241 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/libcharset.h +45 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/Headers/localcharset.h +137 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e/libcharset.a +0 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +241 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +45 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +137 -0
- package/dist/prebuilt/charset.xcframework/ios-arm64_arm64e_x86_64-simulator/libcharset.a +0 -0
- package/dist/prebuilt/iOS-iphoneos/include/iconv.h +241 -0
- package/dist/prebuilt/iOS-iphoneos/include/libcharset.h +45 -0
- package/dist/prebuilt/iOS-iphoneos/include/localcharset.h +137 -0
- package/dist/prebuilt/iOS-iphoneos/lib/libcharset.a +0 -0
- package/dist/prebuilt/iOS-iphoneos/lib/libcharset.la +41 -0
- package/dist/prebuilt/iOS-iphoneos/lib/libiconv.a +0 -0
- package/dist/prebuilt/iOS-iphoneos/lib/libiconv.la +41 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.1.html +205 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconv.3.html +206 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_close.3.html +89 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open.3.html +345 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconv_open_into.3.html +132 -0
- package/dist/prebuilt/iOS-iphoneos/share/doc/iconvctl.3.html +170 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man1/iconv.1 +108 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv.3 +92 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_close.3 +31 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open.3 +254 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconv_open_into.3 +47 -0
- package/dist/prebuilt/iOS-iphoneos/share/man/man3/iconvctl.3 +67 -0
- package/dist/prebuilt/iOS-iphonesimulator/include/iconv.h +241 -0
- package/dist/prebuilt/iOS-iphonesimulator/include/libcharset.h +45 -0
- package/dist/prebuilt/iOS-iphonesimulator/include/localcharset.h +137 -0
- package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.a +0 -0
- package/dist/prebuilt/iOS-iphonesimulator/lib/libcharset.la +41 -0
- package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.a +0 -0
- package/dist/prebuilt/iOS-iphonesimulator/lib/libiconv.la +41 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.1.html +205 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv.3.html +206 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_close.3.html +89 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open.3.html +345 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconv_open_into.3.html +132 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/doc/iconvctl.3.html +170 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man1/iconv.1 +108 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv.3 +92 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_close.3 +31 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open.3 +254 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconv_open_into.3 +47 -0
- package/dist/prebuilt/iOS-iphonesimulator/share/man/man3/iconvctl.3 +67 -0
- package/dist/prebuilt/iconv.xcframework/Info.plist +50 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/iconv.h +241 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/libcharset.h +45 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/Headers/localcharset.h +137 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e/libiconv.a +0 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/iconv.h +241 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/libcharset.h +45 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/Headers/localcharset.h +137 -0
- package/dist/prebuilt/iconv.xcframework/ios-arm64_arm64e_x86_64-simulator/libiconv.a +0 -0
- 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
|
+
− 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
|
+
<iconv.h></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 "illegal sequence
|
|
103
|
+
discard and continue" 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 "illegal sequence
|
|
112
|
+
discard and continue" 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 −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 >= 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)
|