gtk2.0编码转换函数g_convert和g_locale_to_utf8

⌚Time: 2025-12-08 23:08:00

👨‍💻Author: Jack Ge

我在初期使用gtk2的时候经常遇到中文乱码问题。就使用g_locale_to_utf8 和 g_convert转换编码。

需要明白gtk控件使用的都是utf8编码。而使用某些函数比如windows ansi api。得到的是ansi编码。比如gbk中文编码。gtk使用就需要通过函数转换成utf8编码。

gtk处理的字符串如果需要传递给其它ansi函数，比如fopen()或 ifstream这类函数使用ANSI代码页。就需要将utf8编码转换回ansi编码。

g_locale_to_utf8 和 g_convert都是 GLib 中用于处理字符串编码转换的函数，但用途和场景有区别。

g_locale_to_utf8 - 本地编码转 UTF-8

gchar* g_locale_to_utf8(
    const gchar* opsysstring,      // 输入：本地编码的字符串
    gssize len,                    // 输入长度（-1 表示以\0结尾）
    gsize* bytes_read,             // 输出：成功读取的字节数（可传NULL）
    gsize* bytes_written,          // 输出：写入的字节数（可传NULL）
    GError** error                 // 输出：错误信息（可传NULL）
);

当你拿到一个来自“系统本地环境”的字符串，但不确定它是GBK、Big5还是Shift_JIS时，用这个函数安全地转为UTF-8。

// 示例：将可能为本地编码的命令行参数argv[1]转为UTF-8
gchar* local_string = argv[1]; // 例如来自main(int argc, char** argv)
GError* error = NULL;
gchar* utf8_string = g_locale_to_utf8(local_string, -1, NULL, NULL, &error);

if (utf8_string) {
    // 现在utf8_string可以安全地用于GTK控件了
    gtk_label_set_text(GTK_LABEL(label), utf8_string);
    g_free(utf8_string); // 必须释放！
} else {
    g_printerr("转换失败: %s\n", error->message);
    g_error_free(error);
}

g_convert - 通用编码转换

gchar* g_convert(
    const gchar* str,              // 输入字符串
    gssize len,                    // 输入长度（-1 表示以\0结尾）
    const gchar* to_codeset,       // 目标编码（如 "UTF-8", "GBK"）
    const gchar* from_codeset,     // 源编码（如 "ISO-8859-1"）
    gsize* bytes_read,             // 输出：成功读取的字节数
    gsize* bytes_written,          // 输出：写入的字节数
    GError** error                 // 输出：错误信息
);

何时使用：当你明确知道字符串的源编码和目标编码时。

// 示例1：将已知为GBK编码的文件内容转为UTF-8
gchar* gbk_content = ...; // 从GBK编码文件读取的数据
GError* error = NULL;
gchar* utf8_content = g_convert(gbk_content, -1,
                                "UTF-8",   // 目标编码
                                "GBK",     // 源编码（必须准确知道）
                                NULL, NULL, &error);

**注意：**两个函数返回的字符串都需要调用 g_free() 释放。