// 示例代码1
#include <iconv.h>

int main()
{
    // 编码转换的源编码文本
    constchar utf8[] = "幻想";
    // 转换后的编码的储存位置
    char buff[20] = { 0 };
    // in_size值是7, 如果使用strlen则是6，都可以
    size_t in_size = sizeof(utf8);
    // 这里是 UTF-8 转 GB2312
    iconv_t co = iconv_open( "GB2312", "UTF-8");
    do {
        if (co == (iconv_t)(-1)) {
            // iconv_open失败
            break;
        }
        // 这里一定要使用一个新的指针变量，iconv函数不能直接使用变量 utf8
        // 因为 utf8 作为一个指针，是不能修改的，这不符合iconv的用法
        char* in_buff = (char*)(utf8);
        // 输出内存段的起始位置
        size_t out_size = sizeof(buff);
        // 这里也需要使用一个新的指针变量
        char* out_buff = (char*)(buff);
        // 在iconv执行前:
        // in_buff == utf8 而且 out_buff == buff
        size_t result = iconv(co, &in_buff, &in_size, &out_buff, &out_size);
        // 在iconv执行前:
        // in_buff != utf8 而且 out_buff != buff
        // 通常为 in_buff > utf8 而且 out_buff > buff
        // 并且 in_size 和 out_size 的值也会变小
        // -------------------
        // GB2312的编码结果存在的内存起点为 buff, 长度为 sizeof(buff) - out_size
        // result == (iconv_t)(-1) 为失败
    } while(false);
    if (co != (iconv_t)(-1)) {
        // 这里回收 iconv_open 的资源
        iconv_close(co);
    }
}