embedaddon/libiconv/man/iconv.1.html - view

File: [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / man / iconv.1.html
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Tue May 29 09:29:43 2012 UTC (12 years, 1 month ago) by misho
Branches: libiconv, MAIN
CVS tags: v1_14p0, v1_14, HEAD

libiconv v1.14

1:  2:  3: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 4: "http://www.w3.org/TR/html4/loose.dtd"> 5: <html> 6: <head> 7: <meta name="generator" content="groff -Thtml, see www.gnu.org"> 8: <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 9: <meta name="Content-Style" content="text/css"> 10: <style type="text/css"> 11: p { margin-top: 0; margin-bottom: 0; vertical-align: top } 12: pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 13: table { margin-top: 0; margin-bottom: 0; vertical-align: top } 14: h1 { text-align: center } 15: </style> 16: <title>ICONV</title> 17: 18: </head> 19: <body> 20: 21: <h1 align="center">ICONV</h1> 22: 23: <a href="#NAME">NAME</a>  24: <a href="#SYNOPSIS">SYNOPSIS</a>  25: <a href="#DESCRIPTION">DESCRIPTION</a>  26: <a href="#EXAMPLES">EXAMPLES</a>  27: <a href="#CONFORMING TO">CONFORMING TO</a>  28: <a href="#SEE ALSO">SEE ALSO</a>  29: 30: <hr> 31: 32: 33: <h2>NAME 34: <a name="NAME"></a> 35: </h2> 36: 37: 38: iconv − 39: character set conversion 40: 41: <h2>SYNOPSIS 42: <a name="SYNOPSIS"></a> 43: </h2> 44: 45: 46: iconv 47: [OPTION...] [−f encoding] 48: [−t encoding] [inputfile ...] 49:   50: iconv −l 51: 52: <h2>DESCRIPTION 53: <a name="DESCRIPTION"></a> 54: </h2> 55: 56: 57: The 58: iconv program converts text from one encoding to 59: another encoding. More precisely, it converts from 60: the encoding given for the −f option to 61: the encoding given for the −t option. Either of 62: these encodings defaults to the encoding of the current 63: locale. All the inputfiles are read and converted in 64: turn; if no inputfile is given, the standard input is 65: used. The converted text is printed to standard output. 66: 67: The encodings 68: permitted are system dependent. For the libiconv 69: implementation, they are listed in the iconv_open(3) manual 70: page. 71: 72: Options 73: controlling the input and output format:   74: −f encoding, 75: −−from−code=encoding 76: 77: Specifies the encoding of the 78: input. 79: 80: −t 81: encoding, 82: −−to−code=encoding 83: 84: Specifies the encoding of the 85: output. 86: 87: Options 88: controlling conversion problems: 89: 90: <table width="100%" border="0" rules="none" frame="void" 91: cellspacing="0" cellpadding="0"> 92: <tr valign="top" align="left"> 93: <td width="11%"></td> 94: <td width="3%"> 95: 96: 97: −c</td> 98: <td width="8%"></td> 99: <td width="78%"> 100: 101: 102: When this option is given, characters that cannot be 103: converted are silently discarded, instead of leading to a 104: conversion error.</td></tr> 105: </table> 106: 107: 108: −−unicode−subst=formatstring 109: 110: When this option is given, 111: Unicode characters that cannot be represented in the target 112: encoding are replaced with a placeholder string that is 113: constructed from the given formatstring, applied to 114: the Unicode code point. The formatstring must be a 115: format string in the same format as for the printf 116: command or the printf() function, taking either no 117: argument or exactly one unsigned integer argument. 118: 119: 120: −−byte−subst=formatstring 121: 122: When this option is given, 123: bytes in the input that are not valid in the source encoding 124: are replaced with a placeholder string that is constructed 125: from the given formatstring, applied to the 126: byte’s value. The formatstring must be a format 127: string in the same format as for the printf command 128: or the printf() function, taking either no argument 129: or exactly one unsigned integer argument. 130: 131: 132: −−widechar−subst=formatstring 133: 134: When this option is given, wide 135: characters in the input that are not valid in the source 136: encoding are replaced with a placeholder string that is 137: constructed from the given formatstring, applied to 138: the byte’s value. The formatstring must be a 139: format string in the same format as for the printf 140: command or the printf() function, taking either no 141: argument or exactly one unsigned integer argument. 142: 143: Options 144: controlling error output:   145: −s, −−silent 146: 147: When this option is given, 148: error messages about invalid or unconvertible characters are 149: omitted, but the actual converted text is unaffected. 150: 151: The iconv 152: −l or iconv −−list command 153: lists the names of the supported encodings, in a system 154: dependent format. For the libiconv implementation, the names 155: are printed in upper case, separated by whitespace, and 156: alias names of an encoding are listed on the same line as 157: the encoding itself. 158: 159: <h2>EXAMPLES 160: <a name="EXAMPLES"></a> 161: </h2> 162: 163: 164: iconv 165: −f ISO−8859−1 −t UTF−8 166: 167: converts input from the old 168: West-European encoding ISO−8859−1 to 169: Unicode. 170: 171: iconv 172: −f KOI8−R 173: −−byte−subst="<0x%x>"   174: 175: −−unicode−subst="<U+%04X>" 176: 177: converts input from the old 178: Russian encoding KOI8−R to the locale encoding, 179: substituting an angle bracket notation with hexadecimal 180: numbers for invalid bytes and for valid but unconvertible 181: characters. 182: 183: iconv 184: −−list 185: 186: lists the supported 187: encodings. 188: 189: <h2>CONFORMING TO 190: <a name="CONFORMING TO"></a> 191: </h2> 192: 193: 194: POSIX:2001 195: 196: <h2>SEE ALSO 197: <a name="SEE ALSO"></a> 198: </h2> 199: 200: 201: 202: iconv_open(3), 203: locale(7) 204: <hr> 205: </body> 206: </html>