[BACK]Return to iconv.1.html CVS log [TXT] [DIR] Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / man

Diff for /embedaddon/libiconv/man/iconv.1.html between versions 1.1 and 1.1.1.3

version 1.1, 2012/02/21 22:57:48 version 1.1.1.3, 2021/03/17 13:38:46
Line 1 Line 1
<!-- Creator     : groff version 1.18.1 --><!-- Creator     : groff version 1.22.3 -->
<!-- CreationDate: Tue Jun 30 22:52:08 2009 --><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>  <html>
 <head>  <head>
 <meta name="generator" content="groff -Thtml, see www.gnu.org">  <meta name="generator" content="groff -Thtml, see www.gnu.org">
   <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">  <meta name="Content-Style" content="text/css">
   <style type="text/css">
          p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
          pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
          table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
          h1      { text-align: center }
   </style>
 <title>ICONV</title>  <title>ICONV</title>
   
 </head>  </head>
 <body>  <body>
   
<h1 align=center>ICONV</h1><h1 align="center">ICONV</h1>
 
 <a href="#NAME">NAME</a><br>  <a href="#NAME">NAME</a><br>
 <a href="#SYNOPSIS">SYNOPSIS</a><br>  <a href="#SYNOPSIS">SYNOPSIS</a><br>
 <a href="#DESCRIPTION">DESCRIPTION</a><br>  <a href="#DESCRIPTION">DESCRIPTION</a><br>
Line 17 Line 27
 <a href="#SEE ALSO">SEE ALSO</a><br>  <a href="#SEE ALSO">SEE ALSO</a><br>
   
 <hr>  <hr>
   
   
   <h2>NAME
 <a name="NAME"></a>  <a name="NAME"></a>
<h2>NAME</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">iconv &minus;
<tr valign="top" align="left">character set conversion</p>
<td width="10%"></td>
<td width="89%"><h2>SYNOPSIS
<p>iconv &minus; character set conversion</p> 
</td> 
</table> 
 <a name="SYNOPSIS"></a>  <a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">iconv
<tr valign="top" align="left">[<i>OPTION</i>...] [<b>&minus;f</b> <i>encoding</i>]
<td width="10%"></td>[<b>&minus;t</b> <i>encoding</i>] [<i>inputfile</i> ...]
<td width="89%"><br>
<pre>iconv [<i>OPTION</i>...] [<b>&minus;f</b> <i>encoding</i>] [<b>&minus;t</b> <i>encoding</i>] [<i>inputfile</i> ...]iconv <b>&minus;l</b></p>
iconv <b>&minus;l
</b></pre><h2>DESCRIPTION
</td> 
</table> 
 <a name="DESCRIPTION"></a>  <a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2></h2>
<!-- INDENTATION --> 
   
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">The
<tr valign="top" align="left"><b>iconv</b> program converts text from one encoding to
<td width="10%"></td>another encoding. More precisely, it converts <b>from</b>
<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>&minus;f</b> option <b>to</b>  the encoding given for the <b>&minus;f</b> option <b>to</b>
 the encoding given for the <b>&minus;t</b> option. Either of  the encoding given for the <b>&minus;t</b> option. Either of
 these encodings defaults to the encoding of the current  these encodings defaults to the encoding of the current
 locale. All the <i>inputfile</i>s are read and converted in  locale. All the <i>inputfile</i>s are read and converted in
 turn; if no <i>inputfile</i> is given, the standard input is  turn; if no <i>inputfile</i> is given, the standard input is
 used. The converted text is printed to standard output.</p>  used. The converted text is printed to standard output.</p>
<!-- INDENTATION -->
<p>The encodings permitted are system dependent. For the<p style="margin-left:11%; margin-top: 1em">The encodings
libiconv implementation, they are listed in thepermitted are system dependent. For the libiconv
iconv_open(3) manual page.</p>implementation, they are listed in the iconv_open(3) manual
<!-- INDENTATION -->page.</p>
<p>Options controlling the input and output format:</p>
</td><p style="margin-left:11%; margin-top: 1em">Options
</table>controlling the input and output format: <b><br>
<!-- INDENTATION -->&minus;f</b> <i>encoding</i>,
<table width="100%" border=0 rules="none" frame="void"<b>&minus;&minus;from&minus;code=</b><i>encoding</i></p>
       cols="2" cellspacing="0" cellpadding="0">
 <p style="margin-left:22%;">Specifies the encoding of the
 input.</p>
 
 <p style="margin-left:11%;"><b>&minus;t</b>
 <i>encoding</i>,
 <b>&minus;&minus;to&minus;code=</b><i>encoding</i></p>
 
 <p style="margin-left:22%;">Specifies the encoding of the
 output.</p>
 
 <p style="margin-left:11%; margin-top: 1em">Options
 controlling conversion problems:</p>
 
 <table width="100%" border="0" rules="none" frame="void"
        cellspacing="0" cellpadding="0">
 <tr valign="top" align="left">  <tr valign="top" align="left">
<td width="10%"></td><td width="11%"></td>
<td width="89%"><td width="3%">
<p><b>&minus;f</b> <i>encoding</i>, 
<b>&minus;&minus;from&minus;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>&minus;t</b> <i>encoding</i>, 
<b>&minus;&minus;to&minus;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>&minus;c</b></p>  
 </td>  
 <td width="5%"></td>  
 <td width="77%">  
   
   <p><b>&minus;c</b></p></td>
   <td width="8%"></td>
   <td width="78%">
   
   
 <p>When this option is given, characters that cannot be  <p>When this option is given, characters that cannot be
 converted are silently discarded, instead of leading to a  converted are silently discarded, instead of leading to a
conversion error.</p>conversion error.</p></td></tr>
</td> 
 </table>  </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>&minus;&minus;unicode&minus;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>&minus;&minus;byte&minus;subst=</b><i>formatstring</i></p></td><p style="margin-left:11%;"><b>&minus;&minus;unicode&minus;subst=</b><i>formatstring</i></p>
</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&rsquo;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>&minus;&minus;widechar&minus;subst=</b><i>formatstring</i></p></td><p style="margin-left:22%;">When this option is given,
</table>Unicode characters that cannot be represented in the target
<!-- INDENTATION -->encoding are replaced with a placeholder string that is
<table width="100%" border=0 rules="none" frame="void"constructed from the given <i>formatstring</i>, applied to
       cols="2" cellspacing="0" cellpadding="0">the Unicode code point. The <i>formatstring</i> must be a
<tr valign="top" align="left">format string in the same format as for the <i>printf</i>
<td width="21%"></td>command or the <i>printf()</i> function, taking either no
<td width="77%">argument or exactly one unsigned integer argument.</p>
<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<p style="margin-left:11%;"><b>&minus;&minus;byte&minus;subst=</b><i>formatstring</i></p>
<i>formatstring</i>, applied to the byte&rsquo;s value. The
<i>formatstring</i> must be a format string in the same<p style="margin-left:22%;">When this option is given,
format as for the <i>printf</i> command or thebytes in the input that are not valid in the source encoding
<i>printf()</i> function, taking either no argument orare replaced with a placeholder string that is constructed
exactly one unsigned integer argument.</p>from the given <i>formatstring</i>, applied to the
</td>byte&rsquo;s value. The <i>formatstring</i> must be a format
</table>string in the same format as for the <i>printf</i> command
<!-- INDENTATION -->or the <i>printf()</i> function, taking either no argument
<table width="100%" border=0 rules="none" frame="void"or exactly one unsigned integer argument.</p>
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:11%;"><b>&minus;&minus;widechar&minus;subst=</b><i>formatstring</i></p>
<td width="89%">
<p>Options controlling error output:</p><p style="margin-left:22%;">When this option is given, wide
</td>characters in the input that are not valid in the source
</table>encoding are replaced with a placeholder string that is
<!-- INDENTATION -->constructed from the given <i>formatstring</i>, applied to
<table width="100%" border=0 rules="none" frame="void"the byte&rsquo;s value. The <i>formatstring</i> must be a
       cols="2" cellspacing="0" cellpadding="0">format string in the same format as for the <i>printf</i>
<tr valign="top" align="left">command or the <i>printf()</i> function, taking either no
<td width="10%"></td>argument or exactly one unsigned integer argument.</p>
<td width="89%">
<p><b>&minus;s</b>, <b>&minus;&minus;silent</b></p></td><p style="margin-left:11%; margin-top: 1em">Options
</table>controlling error output: <b><br>
<!-- INDENTATION -->&minus;s</b>, <b>&minus;&minus;silent</b></p>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:22%;">When this option is given,
<tr valign="top" align="left">error messages about invalid or unconvertible characters are
<td width="21%"></td>omitted, but the actual converted text is unaffected.</p>
<td width="77%">
<p>When this option is given, error messages about invalid<p style="margin-left:11%; margin-top: 1em">The <b>iconv
or unconvertible characters are omitted, but the actual&minus;l</b> or <b>iconv &minus;&minus;list</b> command
converted text is unaffected.</p>lists the names of the supported encodings, in a system
</td>dependent format. For the libiconv implementation, the names
</table>are printed in upper case, separated by whitespace, and
<!-- INDENTATION -->alias names of an encoding are listed on the same line as
<table width="100%" border=0 rules="none" frame="void"the encoding itself.</p>
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"><h2>EXAMPLES
<td width="10%"></td> 
<td width="89%"> 
<p>The <b>iconv &minus;l</b> or <b>iconv 
&minus;&minus;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>  <a name="EXAMPLES"></a>
<h2>EXAMPLES</h2></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 &minus;f ISO&minus;8859&minus;1 &minus;t 
UTF&minus;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&minus;8859&minus;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 &minus;f KOI8&minus;R &minus;&minus;byte&minus;subst=&quot;&lt;0x%x&gt;&quot; 
                &minus;&minus;unicode&minus;subst=&quot;&lt;U+%04X&gt;&quot; 
</b></pre> 
</td> 
</table> 
<!-- INDENTATION --> 
   
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em"><b>iconv
<tr valign="top" align="left">&minus;f ISO&minus;8859&minus;1 &minus;t UTF&minus;8</b></p>
<td width="20%"></td>
<td width="79%"><p style="margin-left:22%;">converts input from the old
<p>converts input from the old Russian encoding KOI8&minus;RWest-European encoding ISO&minus;8859&minus;1 to
to the locale encoding, substituting an angle bracketUnicode.</p>
notation with hexadecimal numbers for invalid bytes and for
valid but unconvertible characters.</p></td><p style="margin-left:11%; margin-top: 1em"><b>iconv
</table>&minus;f KOI8&minus;R
<!-- INDENTATION -->&minus;&minus;byte&minus;subst=&quot;&lt;0x%x&gt;&quot; <br>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">&minus;&minus;unicode&minus;subst=&quot;&lt;U+%04X&gt;&quot;</b></p>
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:22%;">converts input from the old
<td width="89%">Russian encoding KOI8&minus;R to the locale encoding,
<p><b>iconv &minus;&minus;list</b></p></td>substituting an angle bracket notation with hexadecimal
</table>numbers for invalid bytes and for valid but unconvertible
<!-- INDENTATION -->characters.</p>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%;"><b>iconv
<tr valign="top" align="left">&minus;&minus;list</b></p>
<td width="21%"></td>
<td width="77%"><p style="margin-left:22%;">lists the supported
<p>lists the supported encodings.</p>encodings.</p>
</td>
</table><h2>CONFORMING TO
 <a name="CONFORMING TO"></a>  <a name="CONFORMING TO"></a>
<h2>CONFORMING TO</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
<tr valign="top" align="left">
<td width="10%"></td><h2>SEE ALSO
<td width="89%"> 
<p>POSIX:2001</p> 
</td> 
</table> 
 <a name="SEE ALSO"></a>  <a name="SEE ALSO"></a>
<h2>SEE ALSO</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"><p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3),
<td width="10%"></td><b>locale</b>(7)</p>
<td width="89%"> 
<p><b>iconv_open</b>(3), <b>locale</b>(7)</p> 
</td> 
</table> 
 <hr>  <hr>
 </body>  </body>
 </html>  </html>
Removed from v.1.1  
changed lines
  Added in v.1.1.1.3

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>