libiconv/man/iconv.1.html

   1 <html>
   2 <head>
   3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   4 <meta name="Content-Style" content="text/css">
   5 <title>ICONV</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>ICONV</h1>
  10 <a href="#NAME">NAME</a><br>
  11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  13 <a href="#SEE ALSO">SEE ALSO</a><br>
  14
  15 <hr>
  16 <!-- Creator     : groff version 1.17 -->
  17 <!-- CreationDate: Fri May 24 14:48:03 2002 -->
  18 <a name="NAME"></a>
  19 <h2>NAME</h2>
  20 <table width="100%" border=0 rules="none" frame="void"
  21        cols="2" cellspacing="0" cellpadding="0">
  22 <tr valign="top" align="left">
  23 <td width="10%"></td><td width="90%">
  24 iconv - character set conversion</td></table>
  25 <a name="SYNOPSIS"></a>
  26 <h2>SYNOPSIS</h2>
  27
  28 <table width="100%" border=0 rules="none" frame="void"
  29        cols="2" cellspacing="0" cellpadding="0">
  30 <tr valign="top" align="left">
  31 <td width="10%"></td><td width="90%">
  32 <pre>iconv [<b>-c</b>] [<b>-s</b>] [<b>-f</b> <i>encoding</i>] [<b>-t</b> <i>encoding</i>] [<i>inputfile</i> ...]
  33 iconv <b>-l
  34 </b></pre></td></table>
  35 <a name="DESCRIPTION"></a>
  36 <h2>DESCRIPTION</h2>
  37
  38 <table width="100%" border=0 rules="none" frame="void"
  39        cols="2" cellspacing="0" cellpadding="0">
  40 <tr valign="top" align="left">
  41 <td width="10%"></td><td width="90%">
  42 The <b>iconv</b> program converts text from one encoding to
  43 another encoding. More precisely, it converts <b>from</b>
  44 the encoding given for the <b>-f</b> option <b>to</b> the
  45 encoding given for the <b>-t</b> option. Either of these
  46 encodings defaults to the encoding of the current locale.
  47 All the <i>inputfile</i>s are read and converted in turn; if
  48 no <i>inputfile</i> is given, the standard input is used.
  49 The converted text is printed to standard
  50 output.</td></table>
  51
  52 <table width="100%" border=0 rules="none" frame="void"
  53        cols="2" cellspacing="0" cellpadding="0">
  54 <tr valign="top" align="left">
  55 <td width="10%"></td><td width="90%">
  56 When option <b>-c</b> is given, characters that cannot be
  57 converted are silently discarded, instead of leading to a
  58 conversion error.</td></table>
  59
  60 <table width="100%" border=0 rules="none" frame="void"
  61        cols="2" cellspacing="0" cellpadding="0">
  62 <tr valign="top" align="left">
  63 <td width="10%"></td><td width="90%">
  64 When option <b>-s</b> is given, error messages about invalid
  65 or unconvertible characters are omitted, but the actual
  66 converted text is unaffected.</td></table>
  67
  68 <table width="100%" border=0 rules="none" frame="void"
  69        cols="2" cellspacing="0" cellpadding="0">
  70 <tr valign="top" align="left">
  71 <td width="10%"></td><td width="90%">
  72 The encodings permitted are system dependent. For the
  73 libiconv implementation, they are listed in the
  74 iconv_open(3) manual page.</td></table>
  75
  76 <table width="100%" border=0 rules="none" frame="void"
  77        cols="2" cellspacing="0" cellpadding="0">
  78 <tr valign="top" align="left">
  79 <td width="10%"></td><td width="90%">
  80 The <b>iconv -l</b> command lists the names of the supported
  81 encodings, in a system dependent format. For the libiconv
  82 implementation, the names are printed in upper case,
  83 separated by whitespace, and alias names of an encoding are
  84 listed on the same line as the encoding itself.</td></table>
  85 <a name="SEE ALSO"></a>
  86 <h2>SEE ALSO</h2>
  87
  88 <table width="100%" border=0 rules="none" frame="void"
  89        cols="2" cellspacing="0" cellpadding="0">
  90 <tr valign="top" align="left">
  91 <td width="10%"></td><td width="90%">
  92 <b>iconv_open</b>(3), <b>locale</b>(7)</td></table>
  93 <hr>
  94 </body>
  95 </html>