iconv：基本 API

iconv 是一个用于字符编码转换的标准 C 库函数。它常用于在不同的操作系统和程序之间交换数据时，将数据从一种字符编码转换为另一种字符编码。在本文中，我们将介绍 iconv 基本 API，以及如何使用它进行字符编码转换。

使用前准备

在使用 iconv 函数之前，我们需要确保已经安装了 iconv 库。在 Linux 系统中，可以通过以下命令来安装该库：

sudo apt-get install libiconv2-dev

在 Windows 系统中，我们需要下载并安装 GNUWin32 包含 iconv 库的二进制文件。

基本用法

转换函数基本格式如下：

size_t iconv(iconv_t cd, char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft);

其中，

• cd: iconv 的转换描述符，一个不透明的指针，可以由函数 iconv_open 打开。
• inbuf: 指向输入缓冲区的指针。
• inbytesleft: 输入缓冲区的大小，以字节数表示。
• outbuf: 指向输出缓冲区的指针。
• outbytesleft: 输出缓冲区的大小，以字节数表示。

函数返回值为成功转换的字符数。如果在转换过程中出现错误，则返回 -1，并设置 errno。

我们可以使用 iconv_open 函数打开一个转换描述符，用于后续的转换操作。该函数的原型如下：

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

其中，

• tocode: 目标编码。
• fromcode: 源编码。

函数返回值为一个不透明的指针，代表该转换描述符。如果转换描述符创建失败，则返回 (iconv_t) -1。

转换过程中，我们需要对输入和输出缓冲区进行管理。通常情况下，我们会先将要进行转换的字符存入输入缓冲区，随后进行转换操作，并将转换结果存入输出缓冲区。最后，我们需要再次检查输入缓冲区和输出缓冲区的大小，以便确保转换操作已经完成。

下面是一个转换 UTF-8 到 GB2312 编码的例子：

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <iconv.h>

int main(int argc, char* argv[])
{
    iconv_t cd = iconv_open("GB2312", "UTF-8");
    if (cd == (iconv_t)-1) {
        perror("iconv_open failed");
        exit(1);
    }

    char* inbuf = "简体中文";
    size_t inbytesleft = strlen(inbuf) + 1;

    size_t outbytesleft = 1024;
    char* outbuf = malloc(outbytesleft);

    size_t ret = iconv(cd, &inbuf, &inbytesleft, &outbuf, &outbytesleft);
    if (ret == (size_t)-1) {
        perror("iconv failed");
        exit(1);
    }

    printf("%s\n", outbuf);

    iconv_close(cd);
    free(outbuf);

    return 0;
}

值得注意的是，iconv 函数的第一个参数不能被重复使用。在每次使用该函数进行转换之前，需要确保输入和输出缓冲区的大小被正确地设置。

总结

iconv 是一个可以进行字符编码转换的标准 C 库函数。在使用该函数之前，我们需要确保已经安装了 iconv 库，并了解其基本 API。在使用 iconv 函数进行字符转换时，我们需要管理输入和输出缓冲区的大小，以及转换描述符的正确使用。