Manpages

NAME

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

總 覽 (SYNOPSIS)

#include <iconv.h>

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

描 述 (DESCRIPTION)

iconv_open 函 數 分 配 一 個 用 於 把 fromcode 編 碼 的 字 符 串 轉 換 成 tocode 編 碼 的 轉 換 描 述 符 .

fromcodetocode 所 允 許 的 值 以 及 支 持 的 組 合 方 式 都 是 與 系 統 相 關 的 . 對 於 這 個 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_tuint32_t 表 示 的 Unicode

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

charwchar_t 表 示 的 與 區 域 設 置 相 關 的 編 碼

(其 字 節 順 序 和 對 齊 方 式 與 具 體 機 器 有 關 , 其 語 意 與 操 作 系 統 和 當 前 區 域 設 置 中 的 LC_CTYPE 有 關 ) char, wchar_t 在 tocode 後 面 加 上 "//TRANSLIT" 表 示 , 當 在 目 標 字 符 集 中 不 能 表 示 一 個 字 符 時 , 就 用 同 其 相 似 的 一 個 字 符 來 代 替 . 其 返 回 的 轉 換 描 述 符 可 以 被 iconv 多 次 使 用 . 只 要 沒 有 用 iconv_close 將 其 釋 放 , 它 就 是 有 效 的 . 轉 換 描 述 符 包 含 了 轉 換 的 狀 態 . 在 用 iconv_open 建 立 一 個 描 述 符 時 狀 態 爲 初 始 態 . iconv 會 改 變 它 的 狀 態 . (這 說 明 一 個 描 述 符 不 能 在 多 線 程 中 同 時 使 用 .) 可 以 把 NULL 作 爲 inbuf 傳 給 iconv 來 使 其 回 到 初 始 態 .

返 回 值 (RETURN VALUE)

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

錯 誤 (ERRORS)

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

EINVAL 此 係 統 不 支 持 從

fromcodetocode 的 轉 換 .

遵 循 (CONFORMING TO)

UNIX98

參 見 (SEE ALSO)

iconv(3), iconv_close(3)

[中 文 版 維 護 人 ]

唐 友 <tony_ty [AT] 263.net>

[中 文 版 最 新 更 新 ]

2002/3/21

[中 國 Linux論 壇 man手 冊 頁 翻 譯 計 劃 ]

http://cmpp.linuxforum.net

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh