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

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_OPEN</title>

</head>

<body>

<h1 align="center">ICONV_OPEN</h1>

22

23

<a href="#NAME">NAME</a> 

24

<a href="#SYNOPSIS">SYNOPSIS</a> 

25

<a href="#DESCRIPTION">DESCRIPTION</a> 

26

<a href="#RETURN VALUE">RETURN VALUE</a> 

27

<a href="#ERRORS">ERRORS</a> 

28

<a href="#CONFORMING TO">CONFORMING TO</a> 

29

<a href="#SEE ALSO">SEE ALSO</a> 

<hr>

<h2>NAME

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

</h2>

iconv_open

− allocate descriptor for character set conversion

41

42

<h2>SYNOPSIS

43

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

</h2>

#include

<iconv.h>

iconv_t

iconv_open (const char* tocode, const

char* fromcode);

<h2>DESCRIPTION

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

</h2>

The

iconv_open function allocates a conversion descriptor

61

suitable for converting byte sequences from character

62

encoding fromcode to character encoding

tocode.

The values

permitted for fromcode and tocode and the

67

supported combinations are system dependent. For the

68

libiconv library, the following encodings are supported, in

all combinations. 

European languages

ASCII,

ISO−8859−{1,2,3,4,5,7,9,10,13,14,15,16},

74

KOI8−R, KOI8−U, KOI8−RU,

75

CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},

76

Mac{Roman,CentralEurope,Iceland,Croatian,Romania},

77

Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh

Semitic languages

ISO−8859−{6,8},

CP{1255,1256}, CP862, Mac{Hebrew,Arabic}

Japanese

EUC−JP, SHIFT_JIS, CP932,

87

ISO−2022−JP, ISO−2022−JP−2,

ISO−2022−JP−1

Chinese

EUC−CN, HZ, GBK, CP936,

93

GB18030, EUC−TW, BIG5, CP950, BIG5−HKSCS,

94

BIG5−HKSCS:2004, BIG5−HKSCS:2001,

95

BIG5−HKSCS:1999, ISO−2022−CN,

96

ISO−2022−CN−EXT

97

98

<table width="100%" border="0" rules="none" frame="void"

99

cellspacing="0" cellpadding="0">

100

<tr valign="top" align="left">

101

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

<td width="9%">

Korean</td>

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

<td width="50%">

EUC−KR, CP949, ISO−2022−KR, JOHAB</td>

<td width="28%">

</td></tr>

</table>

Armenian

ARMSCII−8

Georgian

Georgian−Academy,

Georgian−PS

<table width="100%" border="0" rules="none" frame="void"

125

cellspacing="0" cellpadding="0">

126

<tr valign="top" align="left">

127

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

<td width="9%">

Tajik</td>

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

<td width="35%">

KOI8−T</td>

<td width="43%">

</td></tr>

<tr valign="top" align="left">

140

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

<td width="9%">

Kazakh</td>

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

<td width="35%">

PT154, RK1048</td>

<td width="43%">

</td></tr>

<tr valign="top" align="left">

153

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

<td width="9%">

Thai</td>

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

<td width="35%">

TIS−620, CP874, MacThai</td>

<td width="43%">

</td></tr>

</table>

Laotian

MuleLao−1, CP1133

Vietnamese

VISCII, TCVN, CP1258

Platform specifics

HP−ROMAN8, NEXTSTEP

Full Unicode

UTF−8 

UCS−2, UCS−2BE, UCS−2LE 

183

UCS−4, UCS−4BE, UCS−4LE 

184

UTF−16, UTF−16BE, UTF−16LE 

185

UTF−32, UTF−32BE, UTF−32LE 

UTF−7 

C99, JAVA

Full Unicode, in terms of

190

uint16_t or uint32_t

191

192

(with machine dependent

193

endianness and alignment) 

194

UCS−2−INTERNAL, UCS−4−INTERNAL

195

196

Locale dependent, in terms of

197

char or wchar_t

198

199

(with machine dependent

200

endianness and alignment, and with semantics depending on

201

the OS and the current LC_CTYPE locale facet) 

char, wchar_t

When configured

with the option

−−enable−extra−encodings, it

207

also provides support for a few extra encodings: 

European languages

CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}

Semitic languages

CP864

Japanese

EUC−JISX0213,

Shift_JISX0213, ISO−2022−JP−3

Chinese

BIG5−2003

(experimental)

Turkmen

TDS565

Platform specifics

ATARIST,

RISCOS−LATIN1

The empty

encoding name "" is equivalent to

238

"char": it denotes the locale dependent character

encoding.

When the string

"//TRANSLIT" is appended to tocode,

243

transliteration is activated. This means that when a

244

character cannot be represented in the target character set,

245

it can be approximated through one or several characters

246

that look similar to the original character.

247

248

When the string

249

"//IGNORE" is appended to tocode,

250

characters that cannot be represented in the target

251

character set will be silently discarded.

252

253

The resulting

254

conversion descriptor can be used with iconv any

255

number of times. It remains valid until deallocated using

iconv_close.

A conversion

descriptor contains a conversion state. After creation using

260

iconv_open, the state is in the initial state. Using

261

iconv modifies the descriptor’s conversion

262

state. (This implies that a conversion descriptor can not be

263

used in multiple threads simultaneously.) To bring the state

264

back to the initial state, use iconv with NULL as

inbuf argument.

<h2>RETURN VALUE

<a name="RETURN VALUE"></a>

</h2>

The

iconv_open function returns a freshly allocated

274

conversion descriptor. In case of error, it sets

275

errno and returns (iconv_t)(−1).

276

277

<h2>ERRORS

278

<a name="ERRORS"></a>

</h2>

The following

error can occur, among others:

284

285

<table width="100%" border="0" rules="none" frame="void"

286

cellspacing="0" cellpadding="0">

287

<tr valign="top" align="left">

288

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

<td width="9%">

EINVAL</td>

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

<td width="78%">

The conversion from fromcode to tocode is

298

not supported by the implementation.</td></tr>

</table>

<h2>CONFORMING TO

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

</h2>

POSIX:2001

<h2>SEE ALSO

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

</h2>

iconv(3)

iconvctl(3) iconv_close(3)

316

<hr>

317

</body>

318

</html>

nexmon – Blame information for rev 1