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

File: [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / man / iconv.1.html
Revision 1.1.1.3 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Wed Mar 17 13:38:46 2021 UTC (4 years ago) by misho
Branches: libiconv, MAIN
CVS tags: v1_16p0, HEAD

libiconv 1.16

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