| <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="#SEE ALSO">SEE ALSO</a><br> |
| |
| <hr> |
| <!-- Creator : groff version 1.17.2 --> |
| <!-- CreationDate: Mon Jan 23 14:20:53 2006 --> |
| <a name="NAME"></a> |
| <h2>NAME</h2> |
| <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="90%"> |
| iconv - character set conversion</td></table> |
| <a name="SYNOPSIS"></a> |
| <h2>SYNOPSIS</h2> |
| |
| <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="90%"> |
| <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> |
| |
| <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="90%"> |
| 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.</td></table> |
| |
| <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="90%"> |
| The encodings permitted are system dependent. For the |
| libiconv implementation, they are listed in the |
| iconv_open(3) manual page.</td></table> |
| |
| <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="90%"> |
| Options controlling the input and output |
| format:</td></table> |
| |
| <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="90%"> |
| <b>-f</b> <i>encoding</i>, |
| <b>--from-code=</b><i>encoding</i></td></table> |
| |
| <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="79%"> |
| Specifies the encoding of the input.</td></table> |
| |
| <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="90%"> |
| <b>-t</b> <i>encoding</i>, |
| <b>--to-code=</b><i>encoding</i></td></table> |
| |
| <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="79%"> |
| Specifies the encoding of the output.</td></table> |
| |
| <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="90%"> |
| Options controlling conversion problems:</td></table> |
| |
| <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="90%"> |
| <b>-c</b></td></table> |
| |
| <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="79%"> |
| When this option is given, characters that cannot be |
| converted are silently discarded, instead of leading to a |
| conversion error.</td></table> |
| |
| <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="90%"> |
| <b>--unicode-subst=</b><i>formatstring</i></td></table> |
| |
| <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="79%"> |
| 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.</td></table> |
| |
| <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="90%"> |
| <b>--byte-subst=</b><i>formatstring</i></td></table> |
| |
| <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="79%"> |
| 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.</td></table> |
| |
| <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="90%"> |
| <b>--widechar-subst=</b><i>formatstring</i></td></table> |
| |
| <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="79%"> |
| 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.</td></table> |
| |
| <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="90%"> |
| Options controlling error output:</td></table> |
| |
| <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="90%"> |
| <b>-s</b>, <b>--silent</b></td></table> |
| |
| <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="79%"> |
| When this option is given, error messages about invalid or |
| unconvertible characters are omitted, but the actual |
| converted text is unaffected.</td></table> |
| |
| <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="90%"> |
| 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.</td></table> |
| <a name="EXAMPLES"></a> |
| <h2>EXAMPLES</h2> |
| |
| <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="90%"> |
| <b>iconv -f ISO-8859-1 -t UTF-8</b></td></table> |
| |
| <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="79%"> |
| converts input from the old West-European encoding |
| ISO-8859-1 to Unicode.</td></table> |
| |
| <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="90%"> |
| <pre><b>iconv -f KOI8-R --byte-subst="<0x%x>" |
| --unicode-subst="<U+%04X>" |
| </b></pre></td></table> |
| |
| <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="79%"> |
| 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.</td></table> |
| |
| <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="90%"> |
| <b>iconv --list</b></td></table> |
| |
| <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="79%"> |
| lists the supported encodings.</td></table> |
| <a name="SEE ALSO"></a> |
| <h2>SEE ALSO</h2> |
| |
| <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="90%"> |
| <b>iconv_open</b>(3), <b>locale</b>(7)</td></table> |
| <hr> |
| </body> |
| </html> |
