iconv_open 中文man頁面

作者：唐友 2011-08-25 17:00:46

iconv_open 函數(shù) 分配一個用于把 fromcode 編碼的字符串轉換成 tocode 編碼的轉換描述符.

NAME

iconv_open - 分配一個字符集轉換的描述符

總覽 (SYNOPSIS)

#include <iconv.h>

iconv_t iconv_open (const char* tocode, const char* fromcode);

描述 (DESCRIPTION)

iconv_open 函數(shù) 分配一個用于把 fromcode 編碼的字符串轉換成 tocode 編碼的轉換描述符.

fromcode 和 tocode 所允許的值以及支持的組合方式都是與系統(tǒng) 相關的. 對于這個 libiconv 庫, 它支持下面的編碼, 也支持其所有的組合.

歐洲語言

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,Romania}, Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh

閃米特語言

ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}

日文

EUC-JP, SHIFT-JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1

中文

EUC-CN, HZ, GBK, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS, ISO-2022-CN, ISO-2022-CN-EXT

韓文

EUC-KR, CP949, ISO-2022-KR, JOHAB

Armenian

ARMSCII-8

Georgian

Georgian-Academy, Georgian-PS

泰語

TIS-620, CP874, MacThai

撈撾語

MuleLao-1, CP1133

越南語

VISCII, TCVN, CP1258

特定平臺

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
JAVA

用 uint16_t 或 uint32_t 表示的 Unicode

(其字節(jié)順序和對齊方式與具體機器有關) UCS-2-INTERNAL, UCS-4-INTERNAL

用 char 或 wchar_t 表示的與區(qū)域設置相關的編碼

(其字節(jié)順序和對齊方式與具體機器有關, 其語意與操作系統(tǒng) 和當前區(qū)域設置中的 LC_CTYPE 有關) char, wchar_t

在 tocode 后面加上 "//TRANSLIT" 表示, 當在目標字符集中不能表示一個字符時, 就用同其相似的一個字符來代替.

其返回的轉換描述符可以被 iconv 多次使用. 只要沒有用 iconv_close 將其釋放, 它就是有效的.

轉換描述符包含了轉換的狀態(tài). 在用 iconv_open 建立一個描述符時狀態(tài)為初始態(tài). iconv 會改變它的狀態(tài). (這說明一個描述符不能在多線程中同時使用.) 可以把 NULL 作為 inbuf 傳給 iconv 來使其回到初始態(tài).

返回值 (RETURN VALUE)

iconv_open 函數(shù) 返回一個新的轉換描述符. 如果發(fā)生錯誤則設置 errno 變量同時返回 (iconv_t)(-1).

錯誤 (ERRORS)

除了一般的錯誤, 還可能有下面的錯誤:

EINVAL: 此系統(tǒng) 不支持從 fromcode 到 tocode 的轉換.

遵循 (CONFORMING TO)

UNIX98

參見 (SEE ALSO)

iconv(3), iconv_close(3)

#p#

NAME

iconv_open - allocate descriptor for character set conversion

SYNOPSIS

#include <iconv.h>

iconv_t iconv_open(const char *tocode, const char *fromcode);

DESCRIPTION

The iconv_open function allocates a conversion descriptor suitable for converting byte sequences from character encoding fromcode to character encoding tocode.

The values permitted for fromcode and tocode and the supported combinations are system dependent. For the GNU C library, the permitted values are listed by the iconv --list command, and all combinations of the listed values are supported.

The resulting conversion descriptor can be used with iconv any number of times. It remains valid until deallocated 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 simultaneously.) 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 conversion 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