335 lines
10 KiB
HTML
Executable File
335 lines
10 KiB
HTML
Executable File
<!-- Creator : groff version 1.18.1 -->
|
|
<!-- CreationDate: Tue Jun 30 22:52:08 2009 -->
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta name="Content-Style" content="text/css">
|
|
<title>ICONV</title>
|
|
</head>
|
|
<body>
|
|
|
|
<h1 align=center>ICONV</h1>
|
|
<a href="#NAME">NAME</a><br>
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
|
<a href="#EXAMPLES">EXAMPLES</a><br>
|
|
<a href="#CONFORMING TO">CONFORMING TO</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
<a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>iconv − character set conversion</p>
|
|
</td>
|
|
</table>
|
|
<a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<pre>iconv [<i>OPTION</i>...] [<b>−f</b> <i>encoding</i>] [<b>−t</b> <i>encoding</i>] [<i>inputfile</i> ...]
|
|
iconv <b>−l
|
|
</b></pre>
|
|
</td>
|
|
</table>
|
|
<a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
<!-- INDENTATION -->
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>The <b>iconv</b> program converts text from one encoding
|
|
to another encoding. More precisely, it converts <b>from</b>
|
|
the encoding given for the <b>−f</b> option <b>to</b>
|
|
the encoding given for the <b>−t</b> option. Either of
|
|
these encodings defaults to the encoding of the current
|
|
locale. All the <i>inputfile</i>s are read and converted in
|
|
turn; if no <i>inputfile</i> is given, the standard input is
|
|
used. The converted text is printed to standard output.</p>
|
|
<!-- INDENTATION -->
|
|
<p>The encodings permitted are system dependent. For the
|
|
libiconv implementation, they are listed in the
|
|
iconv_open(3) manual page.</p>
|
|
<!-- INDENTATION -->
|
|
<p>Options controlling the input and output format:</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>−f</b> <i>encoding</i>,
|
|
<b>−−from−code=</b><i>encoding</i></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>Specifies the encoding of the input.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>−t</b> <i>encoding</i>,
|
|
<b>−−to−code=</b><i>encoding</i></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>Specifies the encoding of the output.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>Options controlling conversion problems:</p>
|
|
</td>
|
|
</table>
|
|
<!-- TABS -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="4" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="13%"></td>
|
|
<td width="2%">
|
|
|
|
<p><b>−c</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="77%">
|
|
|
|
<p>When this option is given, characters that cannot be
|
|
converted are silently discarded, instead of leading to a
|
|
conversion error.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
|
|
<p><b>−−unicode−subst=</b><i>formatstring</i></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>When this option is given, Unicode characters that cannot
|
|
be represented in the target encoding are replaced with a
|
|
placeholder string that is constructed from the given
|
|
<i>formatstring</i>, applied to the Unicode code point. The
|
|
<i>formatstring</i> must be a format string in the same
|
|
format as for the <i>printf</i> command or the
|
|
<i>printf()</i> function, taking either no argument or
|
|
exactly one unsigned integer argument.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
|
|
<p><b>−−byte−subst=</b><i>formatstring</i></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>When this option is given, bytes in the input that are
|
|
not valid in the source encoding are replaced with a
|
|
placeholder string that is constructed from the given
|
|
<i>formatstring</i>, applied to the byte’s value. The
|
|
<i>formatstring</i> must be a format string in the same
|
|
format as for the <i>printf</i> command or the
|
|
<i>printf()</i> function, taking either no argument or
|
|
exactly one unsigned integer argument.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
|
|
<p><b>−−widechar−subst=</b><i>formatstring</i></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>When this option is given, wide characters in the input
|
|
that are not valid in the source encoding are replaced with
|
|
a placeholder string that is constructed from the given
|
|
<i>formatstring</i>, applied to the byte’s value. The
|
|
<i>formatstring</i> must be a format string in the same
|
|
format as for the <i>printf</i> command or the
|
|
<i>printf()</i> function, taking either no argument or
|
|
exactly one unsigned integer argument.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>Options controlling error output:</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>−s</b>, <b>−−silent</b></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>When this option is given, error messages about invalid
|
|
or unconvertible characters are omitted, but the actual
|
|
converted text is unaffected.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>The <b>iconv −l</b> or <b>iconv
|
|
−−list</b> command lists the names of the
|
|
supported encodings, in a system dependent format. For the
|
|
libiconv implementation, the names are printed in upper
|
|
case, separated by whitespace, and alias names of an
|
|
encoding are listed on the same line as the encoding
|
|
itself.</p>
|
|
</td>
|
|
</table>
|
|
<a name="EXAMPLES"></a>
|
|
<h2>EXAMPLES</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>iconv −f ISO−8859−1 −t
|
|
UTF−8</b></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>converts input from the old West-European encoding
|
|
ISO−8859−1 to Unicode.</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<pre><b>iconv −f KOI8−R −−byte−subst="<0x%x>"
|
|
−−unicode−subst="<U+%04X>"
|
|
</b></pre>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="20%"></td>
|
|
<td width="79%">
|
|
<p>converts input from the old Russian encoding KOI8−R
|
|
to the locale encoding, substituting an angle bracket
|
|
notation with hexadecimal numbers for invalid bytes and for
|
|
valid but unconvertible characters.</p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>iconv −−list</b></p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="21%"></td>
|
|
<td width="77%">
|
|
<p>lists the supported encodings.</p>
|
|
</td>
|
|
</table>
|
|
<a name="CONFORMING TO"></a>
|
|
<h2>CONFORMING TO</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p>POSIX:2001</p>
|
|
</td>
|
|
</table>
|
|
<a name="SEE ALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="89%">
|
|
<p><b>iconv_open</b>(3), <b>locale</b>(7)</p>
|
|
</td>
|
|
</table>
|
|
<hr>
|
|
</body>
|
|
</html>
|