Manpages

NAME

iconv_open - 分 配 一 个 字 符 集 转 换 的 描 述 符

总 览 (SYNOPSIS)

#include <iconv.h>

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

描 述 (DESCRIPTION)

iconv_open 函 数 分 配 一 个 用 于 把 fromcode 编 码 的 字 符 串 转 换 成 tocode 编 码 的 转 换 描 述 符 .

fromcode 和 tocode 所 允 许 的 值 以 及 支 持 的 组 合 方 式 都 是 与 系 统 相 关 的 . 对 于 这 个 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}

Armenian

ARMSCII-8

Georgian

Georgian-Academy, Georgian-PS

特 定 平 台
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

(其 字 节 顺 序 和 对 齐 方 式 与 具 体 机 器 有 关 ) UCS-2-INTERNAL, UCS-4-INTERNAL 用

char 或 wchar_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)

除 了 一 般 的 错 误 , 还 可 能 有 下 面 的 错 误 :

遵 循 (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