123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334 |
- <!-- 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>
|