WebSVN – nexmon – Blame – Rev 1 – /utilities/libiconv/man/iconv.1.html

1

office

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>

</head>

<body>

<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> 

<hr>

<h2>NAME

<a name="NAME"></a>

</h2>

iconv −

character set conversion

40

41

<h2>SYNOPSIS

42

<a name="SYNOPSIS"></a>

</h2>

iconv

[OPTION...] [−f encoding]

48

[−t encoding] [inputfile ...]

 

iconv −l

<h2>DESCRIPTION

<a name="DESCRIPTION"></a>

</h2>

The

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

page.

Options

controlling the input and output format: 

74

−f encoding,

75

−−from−code=encoding

76

77

Specifies the encoding of the

input.

−t

encoding,

−−to−code=encoding

Specifies the encoding of the

output.

Options

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>

<td width="3%">

−c</td>

<td width="8%"></td>

<td width="78%">

When this option is given, characters that cannot be

103

converted are silently discarded, instead of leading to a

104

conversion error.</td></tr>

</table>

−−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>

</h2>

iconv

−f ISO−8859−1 −t UTF−8

166

167

converts input from the old

168

West-European encoding ISO−8859−1 to

Unicode.

iconv

−f KOI8−R

−−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

characters.

iconv

−−list

lists the supported

encodings.

<h2>CONFORMING TO

<a name="CONFORMING TO"></a>

</h2>

POSIX:2001

<h2>SEE ALSO

<a name="SEE ALSO"></a>

</h2>

iconv_open(3),

locale(7)

<hr>

</body>

</html>

nexmon – Blame information for rev 1