diff options
Diffstat (limited to 'jni/iconv/man/iconv.1.html')
-rw-r--r-- | jni/iconv/man/iconv.1.html | 334 |
1 files changed, 334 insertions, 0 deletions
diff --git a/jni/iconv/man/iconv.1.html b/jni/iconv/man/iconv.1.html new file mode 100644 index 0000000..e944bf2 --- /dev/null +++ b/jni/iconv/man/iconv.1.html @@ -0,0 +1,334 @@ +<!-- 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> |