mirror of
git://code.qt.io/qt/qt5.git
synced 2026-02-01 19:36:04 +08:00
153 lines
4.5 KiB
Plaintext
153 lines
4.5 KiB
Plaintext
ICONV_OPEN(3) Linux Programmer's Manual ICONV_OPEN(3)
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
iconv_open - allocate descriptor for character set con-
|
|
version
|
|
|
|
SYNOPSIS
|
|
#include <iconv.h>
|
|
|
|
iconv_t iconv_open (const char* tocode, const char* fromcode);
|
|
|
|
DESCRIPTION
|
|
The iconv_open function allocates a conversion descrip-
|
|
tor suitable for converting byte sequences from charac-
|
|
ter encoding fromcode to character encoding tocode.
|
|
|
|
The values permitted for fromcode and tocode and the
|
|
supported combinations are system dependent. For the
|
|
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},
|
|
KOI8-R, KOI8-U, KOI8-RU,
|
|
CP{1250,1251,1252,1253,1254,1257}, CP{850,866},
|
|
Mac{Roman,CentralEurope,Iceland,Croatian,Roma-
|
|
nia}, Mac{Cyrillic,Ukraine,Greek,Turkish}, Macin-
|
|
tosh
|
|
|
|
Semitic languages
|
|
ISO-8859-{6,8}, CP{1255,1256}, CP862,
|
|
Mac{Hebrew,Arabic}
|
|
|
|
Japanese
|
|
EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP,
|
|
ISO-2022-JP-2, ISO-2022-JP-1
|
|
|
|
Chinese
|
|
EUC-CN, HZ, GBK, GB18030, EUC-TW, BIG5, CP950,
|
|
BIG5-HKSCS, ISO-2022-CN, ISO-2022-CN-EXT
|
|
|
|
Korean
|
|
EUC-KR, CP949, ISO-2022-KR, JOHAB
|
|
|
|
Armenian
|
|
ARMSCII-8
|
|
|
|
Georgian
|
|
Georgian-Academy, Georgian-PS
|
|
|
|
Tajik
|
|
KOI8-T
|
|
|
|
Thai
|
|
TIS-620, CP874, MacThai
|
|
|
|
Laotian
|
|
MuleLao-1, CP1133
|
|
|
|
Vietnamese
|
|
VISCII, TCVN, CP1258
|
|
|
|
Platform specifics
|
|
HP-ROMAN8, NEXTSTEP
|
|
|
|
Full Unicode
|
|
UTF-8
|
|
UCS-2, UCS-2BE, UCS-2LE
|
|
UCS-4, UCS-4BE, UCS-4LE
|
|
UTF-16, UTF-16BE, UTF-16LE
|
|
UTF-32, UTF-32BE, UTF-32LE
|
|
UTF-7
|
|
C99, JAVA
|
|
|
|
Full Unicode, in terms of uint16_t or uint32_t
|
|
(with machine dependent endianness and alignment)
|
|
UCS-2-INTERNAL, UCS-4-INTERNAL
|
|
|
|
Locale dependent, in terms of char or wchar_t
|
|
(with machine dependent endianness and alignment,
|
|
and with semantics depending on the OS and the
|
|
current LC_CTYPE locale facet)
|
|
char, wchar_t
|
|
|
|
When configured with the option --enable-extra-encod-
|
|
ings, it also provides support for a few extra encod-
|
|
ings:
|
|
|
|
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
|
|
|
|
Turkmen
|
|
TDS565
|
|
|
|
Platform specifics
|
|
RISCOS-LATIN1
|
|
|
|
The empty encoding name "" is equivalent to "char": it
|
|
denotes the locale dependent character encoding.
|
|
|
|
When the string "//TRANSLIT" is appended to tocode,
|
|
transliteration is activated. This means that when a
|
|
character cannot be represented in the target character
|
|
set, it can be approximated through one or several simi-
|
|
larly looking characters.
|
|
|
|
When the string "//IGNORE" is appended to tocode, char-
|
|
acters that cannot be represented in the target charac-
|
|
ter set will be silently discarded.
|
|
|
|
The resulting conversion descriptor can be used with
|
|
iconv any number of times. It remains valid until deal-
|
|
located using iconv_close.
|
|
|
|
A conversion descriptor contains a conversion state.
|
|
After creation using iconv_open, the state is in the
|
|
initial state. Using iconv modifies the descriptor's
|
|
conversion state. (This implies that a conversion
|
|
descriptor can not be used in multiple threads simulta-
|
|
neously.) To bring the state back to the initial state,
|
|
use iconv with NULL as inbuf argument.
|
|
|
|
RETURN VALUE
|
|
The iconv_open function returns a freshly allocated con-
|
|
version descriptor. In case of error, it sets errno and
|
|
returns (iconv_t)(-1).
|
|
|
|
ERRORS
|
|
The following error can occur, among others:
|
|
|
|
EINVAL The conversion from fromcode to tocode is not
|
|
supported by the implementation.
|
|
|
|
CONFORMING TO
|
|
UNIX98
|
|
|
|
SEE ALSO
|
|
iconv(3), iconv_close(3)
|
|
|
|
|
|
|
|
GNU May 26, 2002 ICONV_OPEN(3)
|