Annotation of embedaddon/libiconv/man/iconv.1.html, revision 1.1
1.1 ! misho 1: <!-- Creator : groff version 1.18.1 -->
! 2: <!-- CreationDate: Tue Jun 30 22:52:08 2009 -->
! 3: <html>
! 4: <head>
! 5: <meta name="generator" content="groff -Thtml, see www.gnu.org">
! 6: <meta name="Content-Style" content="text/css">
! 7: <title>ICONV</title>
! 8: </head>
! 9: <body>
! 10:
! 11: <h1 align=center>ICONV</h1>
! 12: <a href="#NAME">NAME</a><br>
! 13: <a href="#SYNOPSIS">SYNOPSIS</a><br>
! 14: <a href="#DESCRIPTION">DESCRIPTION</a><br>
! 15: <a href="#EXAMPLES">EXAMPLES</a><br>
! 16: <a href="#CONFORMING TO">CONFORMING TO</a><br>
! 17: <a href="#SEE ALSO">SEE ALSO</a><br>
! 18:
! 19: <hr>
! 20: <a name="NAME"></a>
! 21: <h2>NAME</h2>
! 22: <!-- INDENTATION -->
! 23: <table width="100%" border=0 rules="none" frame="void"
! 24: cols="2" cellspacing="0" cellpadding="0">
! 25: <tr valign="top" align="left">
! 26: <td width="10%"></td>
! 27: <td width="89%">
! 28: <p>iconv − character set conversion</p>
! 29: </td>
! 30: </table>
! 31: <a name="SYNOPSIS"></a>
! 32: <h2>SYNOPSIS</h2>
! 33: <!-- INDENTATION -->
! 34: <table width="100%" border=0 rules="none" frame="void"
! 35: cols="2" cellspacing="0" cellpadding="0">
! 36: <tr valign="top" align="left">
! 37: <td width="10%"></td>
! 38: <td width="89%">
! 39: <pre>iconv [<i>OPTION</i>...] [<b>−f</b> <i>encoding</i>] [<b>−t</b> <i>encoding</i>] [<i>inputfile</i> ...]
! 40: iconv <b>−l
! 41: </b></pre>
! 42: </td>
! 43: </table>
! 44: <a name="DESCRIPTION"></a>
! 45: <h2>DESCRIPTION</h2>
! 46: <!-- INDENTATION -->
! 47:
! 48: <table width="100%" border=0 rules="none" frame="void"
! 49: cols="2" cellspacing="0" cellpadding="0">
! 50: <tr valign="top" align="left">
! 51: <td width="10%"></td>
! 52: <td width="89%">
! 53: <p>The <b>iconv</b> program converts text from one encoding
! 54: to another encoding. More precisely, it converts <b>from</b>
! 55: the encoding given for the <b>−f</b> option <b>to</b>
! 56: the encoding given for the <b>−t</b> option. Either of
! 57: these encodings defaults to the encoding of the current
! 58: locale. All the <i>inputfile</i>s are read and converted in
! 59: turn; if no <i>inputfile</i> is given, the standard input is
! 60: used. The converted text is printed to standard output.</p>
! 61: <!-- INDENTATION -->
! 62: <p>The encodings permitted are system dependent. For the
! 63: libiconv implementation, they are listed in the
! 64: iconv_open(3) manual page.</p>
! 65: <!-- INDENTATION -->
! 66: <p>Options controlling the input and output format:</p>
! 67: </td>
! 68: </table>
! 69: <!-- INDENTATION -->
! 70: <table width="100%" border=0 rules="none" frame="void"
! 71: cols="2" cellspacing="0" cellpadding="0">
! 72: <tr valign="top" align="left">
! 73: <td width="10%"></td>
! 74: <td width="89%">
! 75: <p><b>−f</b> <i>encoding</i>,
! 76: <b>−−from−code=</b><i>encoding</i></p></td>
! 77: </table>
! 78: <!-- INDENTATION -->
! 79: <table width="100%" border=0 rules="none" frame="void"
! 80: cols="2" cellspacing="0" cellpadding="0">
! 81: <tr valign="top" align="left">
! 82: <td width="21%"></td>
! 83: <td width="77%">
! 84: <p>Specifies the encoding of the input.</p>
! 85: </td>
! 86: </table>
! 87: <!-- INDENTATION -->
! 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>
! 92: <td width="89%">
! 93: <p><b>−t</b> <i>encoding</i>,
! 94: <b>−−to−code=</b><i>encoding</i></p></td>
! 95: </table>
! 96: <!-- INDENTATION -->
! 97: <table width="100%" border=0 rules="none" frame="void"
! 98: cols="2" cellspacing="0" cellpadding="0">
! 99: <tr valign="top" align="left">
! 100: <td width="21%"></td>
! 101: <td width="77%">
! 102: <p>Specifies the encoding of the output.</p>
! 103: </td>
! 104: </table>
! 105: <!-- INDENTATION -->
! 106: <table width="100%" border=0 rules="none" frame="void"
! 107: cols="2" cellspacing="0" cellpadding="0">
! 108: <tr valign="top" align="left">
! 109: <td width="10%"></td>
! 110: <td width="89%">
! 111: <p>Options controlling conversion problems:</p>
! 112: </td>
! 113: </table>
! 114: <!-- TABS -->
! 115: <table width="100%" border=0 rules="none" frame="void"
! 116: cols="4" cellspacing="0" cellpadding="0">
! 117: <tr valign="top" align="left">
! 118: <td width="13%"></td>
! 119: <td width="2%">
! 120:
! 121: <p><b>−c</b></p>
! 122: </td>
! 123: <td width="5%"></td>
! 124: <td width="77%">
! 125:
! 126: <p>When this option is given, characters that cannot be
! 127: converted are silently discarded, instead of leading to a
! 128: conversion error.</p>
! 129: </td>
! 130: </table>
! 131: <!-- INDENTATION -->
! 132: <table width="100%" border=0 rules="none" frame="void"
! 133: cols="2" cellspacing="0" cellpadding="0">
! 134: <tr valign="top" align="left">
! 135: <td width="10%"></td>
! 136: <td width="89%">
! 137:
! 138: <p><b>−−unicode−subst=</b><i>formatstring</i></p></td>
! 139: </table>
! 140: <!-- INDENTATION -->
! 141: <table width="100%" border=0 rules="none" frame="void"
! 142: cols="2" cellspacing="0" cellpadding="0">
! 143: <tr valign="top" align="left">
! 144: <td width="21%"></td>
! 145: <td width="77%">
! 146: <p>When this option is given, Unicode characters that cannot
! 147: be represented in the target encoding are replaced with a
! 148: placeholder string that is constructed from the given
! 149: <i>formatstring</i>, applied to the Unicode code point. The
! 150: <i>formatstring</i> must be a format string in the same
! 151: format as for the <i>printf</i> command or the
! 152: <i>printf()</i> function, taking either no argument or
! 153: exactly one unsigned integer argument.</p>
! 154: </td>
! 155: </table>
! 156: <!-- INDENTATION -->
! 157: <table width="100%" border=0 rules="none" frame="void"
! 158: cols="2" cellspacing="0" cellpadding="0">
! 159: <tr valign="top" align="left">
! 160: <td width="10%"></td>
! 161: <td width="89%">
! 162:
! 163: <p><b>−−byte−subst=</b><i>formatstring</i></p></td>
! 164: </table>
! 165: <!-- INDENTATION -->
! 166: <table width="100%" border=0 rules="none" frame="void"
! 167: cols="2" cellspacing="0" cellpadding="0">
! 168: <tr valign="top" align="left">
! 169: <td width="21%"></td>
! 170: <td width="77%">
! 171: <p>When this option is given, bytes in the input that are
! 172: not valid in the source encoding are replaced with a
! 173: placeholder string that is constructed from the given
! 174: <i>formatstring</i>, applied to the byte’s value. The
! 175: <i>formatstring</i> must be a format string in the same
! 176: format as for the <i>printf</i> command or the
! 177: <i>printf()</i> function, taking either no argument or
! 178: exactly one unsigned integer argument.</p>
! 179: </td>
! 180: </table>
! 181: <!-- INDENTATION -->
! 182: <table width="100%" border=0 rules="none" frame="void"
! 183: cols="2" cellspacing="0" cellpadding="0">
! 184: <tr valign="top" align="left">
! 185: <td width="10%"></td>
! 186: <td width="89%">
! 187:
! 188: <p><b>−−widechar−subst=</b><i>formatstring</i></p></td>
! 189: </table>
! 190: <!-- INDENTATION -->
! 191: <table width="100%" border=0 rules="none" frame="void"
! 192: cols="2" cellspacing="0" cellpadding="0">
! 193: <tr valign="top" align="left">
! 194: <td width="21%"></td>
! 195: <td width="77%">
! 196: <p>When this option is given, wide characters in the input
! 197: that are not valid in the source encoding are replaced with
! 198: a placeholder string that is constructed from the given
! 199: <i>formatstring</i>, applied to the byte’s value. The
! 200: <i>formatstring</i> must be a format string in the same
! 201: format as for the <i>printf</i> command or the
! 202: <i>printf()</i> function, taking either no argument or
! 203: exactly one unsigned integer argument.</p>
! 204: </td>
! 205: </table>
! 206: <!-- INDENTATION -->
! 207: <table width="100%" border=0 rules="none" frame="void"
! 208: cols="2" cellspacing="0" cellpadding="0">
! 209: <tr valign="top" align="left">
! 210: <td width="10%"></td>
! 211: <td width="89%">
! 212: <p>Options controlling error output:</p>
! 213: </td>
! 214: </table>
! 215: <!-- INDENTATION -->
! 216: <table width="100%" border=0 rules="none" frame="void"
! 217: cols="2" cellspacing="0" cellpadding="0">
! 218: <tr valign="top" align="left">
! 219: <td width="10%"></td>
! 220: <td width="89%">
! 221: <p><b>−s</b>, <b>−−silent</b></p></td>
! 222: </table>
! 223: <!-- INDENTATION -->
! 224: <table width="100%" border=0 rules="none" frame="void"
! 225: cols="2" cellspacing="0" cellpadding="0">
! 226: <tr valign="top" align="left">
! 227: <td width="21%"></td>
! 228: <td width="77%">
! 229: <p>When this option is given, error messages about invalid
! 230: or unconvertible characters are omitted, but the actual
! 231: converted text is unaffected.</p>
! 232: </td>
! 233: </table>
! 234: <!-- INDENTATION -->
! 235: <table width="100%" border=0 rules="none" frame="void"
! 236: cols="2" cellspacing="0" cellpadding="0">
! 237: <tr valign="top" align="left">
! 238: <td width="10%"></td>
! 239: <td width="89%">
! 240: <p>The <b>iconv −l</b> or <b>iconv
! 241: −−list</b> command lists the names of the
! 242: supported encodings, in a system dependent format. For the
! 243: libiconv implementation, the names are printed in upper
! 244: case, separated by whitespace, and alias names of an
! 245: encoding are listed on the same line as the encoding
! 246: itself.</p>
! 247: </td>
! 248: </table>
! 249: <a name="EXAMPLES"></a>
! 250: <h2>EXAMPLES</h2>
! 251: <!-- INDENTATION -->
! 252: <table width="100%" border=0 rules="none" frame="void"
! 253: cols="2" cellspacing="0" cellpadding="0">
! 254: <tr valign="top" align="left">
! 255: <td width="10%"></td>
! 256: <td width="89%">
! 257: <p><b>iconv −f ISO−8859−1 −t
! 258: UTF−8</b></p></td>
! 259: </table>
! 260: <!-- INDENTATION -->
! 261: <table width="100%" border=0 rules="none" frame="void"
! 262: cols="2" cellspacing="0" cellpadding="0">
! 263: <tr valign="top" align="left">
! 264: <td width="21%"></td>
! 265: <td width="77%">
! 266: <p>converts input from the old West-European encoding
! 267: ISO−8859−1 to Unicode.</p>
! 268: </td>
! 269: </table>
! 270: <!-- INDENTATION -->
! 271: <table width="100%" border=0 rules="none" frame="void"
! 272: cols="2" cellspacing="0" cellpadding="0">
! 273: <tr valign="top" align="left">
! 274: <td width="10%"></td>
! 275: <td width="89%">
! 276: <pre><b>iconv −f KOI8−R −−byte−subst="<0x%x>"
! 277: −−unicode−subst="<U+%04X>"
! 278: </b></pre>
! 279: </td>
! 280: </table>
! 281: <!-- INDENTATION -->
! 282:
! 283: <table width="100%" border=0 rules="none" frame="void"
! 284: cols="2" cellspacing="0" cellpadding="0">
! 285: <tr valign="top" align="left">
! 286: <td width="20%"></td>
! 287: <td width="79%">
! 288: <p>converts input from the old Russian encoding KOI8−R
! 289: to the locale encoding, substituting an angle bracket
! 290: notation with hexadecimal numbers for invalid bytes and for
! 291: valid but unconvertible characters.</p></td>
! 292: </table>
! 293: <!-- INDENTATION -->
! 294: <table width="100%" border=0 rules="none" frame="void"
! 295: cols="2" cellspacing="0" cellpadding="0">
! 296: <tr valign="top" align="left">
! 297: <td width="10%"></td>
! 298: <td width="89%">
! 299: <p><b>iconv −−list</b></p></td>
! 300: </table>
! 301: <!-- INDENTATION -->
! 302: <table width="100%" border=0 rules="none" frame="void"
! 303: cols="2" cellspacing="0" cellpadding="0">
! 304: <tr valign="top" align="left">
! 305: <td width="21%"></td>
! 306: <td width="77%">
! 307: <p>lists the supported encodings.</p>
! 308: </td>
! 309: </table>
! 310: <a name="CONFORMING TO"></a>
! 311: <h2>CONFORMING TO</h2>
! 312: <!-- INDENTATION -->
! 313: <table width="100%" border=0 rules="none" frame="void"
! 314: cols="2" cellspacing="0" cellpadding="0">
! 315: <tr valign="top" align="left">
! 316: <td width="10%"></td>
! 317: <td width="89%">
! 318: <p>POSIX:2001</p>
! 319: </td>
! 320: </table>
! 321: <a name="SEE ALSO"></a>
! 322: <h2>SEE ALSO</h2>
! 323: <!-- INDENTATION -->
! 324: <table width="100%" border=0 rules="none" frame="void"
! 325: cols="2" cellspacing="0" cellpadding="0">
! 326: <tr valign="top" align="left">
! 327: <td width="10%"></td>
! 328: <td width="89%">
! 329: <p><b>iconv_open</b>(3), <b>locale</b>(7)</p>
! 330: </td>
! 331: </table>
! 332: <hr>
! 333: </body>
! 334: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>