Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

iconv_open-分配描述符以进行字符集转换

语法

#include <iconv.h>

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

说明

iconv_open()函数分配一个转换描述符，该描述符适用于将字节序列从字符编码从代码转换为字符编码到代码。

fromcode和tocode以及允许的组合所允许的值取决于系统。对于GNU C库，允许的值由iconv --list命令列出，并且支持列出值的所有组合。此外，GNU C库和GNU libiconv库支持以下两个后缀：

//TRANSLIT

当字符串" // TRANSLIT"附加到tocode时，音译被激活。这意味着当一个字符不能在目标字符集中表示时，可以通过一个或几个外观相似的字符来近似。

//IGNORE

当将字符串" // IGNORE"附加到tocode时，目标字符集中无法表示的字符将被静默丢弃。

生成的转换描述符可与iconv(3)多次使用。在使用iconv_close(3)释放之前，它一直有效。

转换描述符包含转换状态。使用iconv_open()创建后，状态为初始状态。使用iconv(3)修改描述符的转换状态。要将状态恢复为初始状态，请使用iconv(3)并将NULL作为inbuf参数。

返回值

iconv_open()函数返回新分配的转换描述符。如果发生错误，它将设置errno并返回(iconv_t)-1。

错误说明

除其他外，可能发生以下错误：

EINVAL

实现不支持从fromcode到tocode的转换。

版本

从2.1版开始，此功能在glibc中可用。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008，SUSv2。

另外参见

iconv(1)，iconv(3)，iconv_close(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。