0

0

C++如何进行UTF-8和GBK编码转换?(代码示例)

尼克

尼克

发布时间:2025-12-21 14:38:02

|

854人浏览过

|

来源于php中文网

原创

C++中UTF-8与GBK转换需依赖系统API或第三方库:Windows用MultiByteToWideChar/WideCharToMultiByte经UTF-16中转,Linux/macOS用iconv,跨平台推荐Boost.Locale;标准C++不内置该功能。

c++如何进行utf-8和gbk编码转换?(代码示例)

在C++中做UTF-8和GBK编码转换,核心是借助系统API或第三方库完成字节流的重新解释与映射。Windows平台可用MultiByteToWideCharWideCharToMultiByte配合UTF-16中转;Linux/macOS推荐用iconv;跨平台项目可选utf8cppBoost.Locale。纯标准C++不内置编码转换功能。

Windows下用WinAPI双向转换(UTF-8 ↔ GBK)

Windows API以UTF-16(wchar_t)为桥梁:先将源编码转为UTF-16,再转为目标编码。注意CP_UTF8936(GBK代码页)的使用。

示例:UTF-8字符串转GBK

#include 
#include 

std::string utf8_to_gbk(const std::string& utf8_str) {
    if (utf8_str.empty()) return {};

    // UTF-8 → UTF-16
    int wlen = MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, nullptr, 0);
    if (wlen == 0) return {};
    std::wstring wstr(wlen, L'\0');
    MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, &wstr[0], wlen);

    // UTF-16 → GBK (code page 936)
    int len = WideCharToMultiByte(936, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
    if (len == 0) return {};
    std::string gbk_str(len, '\0');
    WideCharToMultiByte(936, 0, wstr.c_str(), -1, &gbk_str[0], len, nullptr, nullptr);

    gbk_str.pop_back(); // 去掉末尾的'\0'
    return gbk_str;
}

std::string gbk_to_utf8(const std::string& gbk_str) {
    if (gbk_str.empty()) return {};

    // GBK → UTF-16
    int wlen = MultiByteToWideChar(936, 0, gbk_str.c_str(), -1, nullptr, 0);
    if (wlen == 0) return {};
    std::wstring wstr(wlen, L'\0');
    MultiByteToWideChar(936, 0, gbk_str.c_str(), -1, &wstr[0], wlen);

    // UTF-16 → UTF-8
    int len = WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
    if (len == 0) return {};
    std::string utf8_str(len, '\0');
    WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, &utf8_str[0], len, nullptr, nullptr);

    utf8_str.pop_back();
    return utf8_str;
}

Linux/macOS下用iconv转换

iconv是POSIX标准接口,需链接-liconv(macOS可能需额外安装)。支持“UTF-8”和“GBK”(部分系统也认“CP936”或“GB18030”)。

立即学习C++免费学习笔记(深入)”;

JSON入门指南 中文WORD版
JSON入门指南 中文WORD版

JSON 即 JavaScript Object Natation,它是一种轻量级的数据交换格式,非常适合于服务器与 JavaScript 的交互。本文将快速讲解 JSON 格式,并通过代码示例演示如何分别在客户端和服务器端进行 JSON 格式数据的处理。

下载
  • 确保iconv_open返回非(iconv_t)(-1),否则编码名不被识别
  • 输入缓冲区要留余量(如+4字节),因UTF-8/GBK单字符最大长度不同
  • 转换后检查iconv返回值是否为0,非0表示错误(如非法序列)

跨平台建议:用Boost.Locale

Boost.Locale封装了底层差异,代码简洁且健壮:

#include 
std::string utf8_to_gbk(const std::string& s) {
    return boost::locale::conv::between(s, "GBK", "UTF-8");
}
std::string gbk_to_utf8(const std::string& s) {
    return boost::locale::conv::between(s, "UTF-8", "GBK");
}

需编译时链接-lboost_locale,并确保系统有对应字符集支持(如glibc含GBK)。

注意事项和常见问题

GBK不是UTF-8的子集,部分GBK字符(如某些生僻汉字、旧版符号)在UTF-8中无对应,反之亦然。转换失败时:

  • WinAPI默认截断非法字节,可设WC_ERR_INVALID_CHARS标志让其报错
  • iconv可设//IGNORE//TRANSLIT后缀处理异常(如"GBK//IGNORE"
  • Boost.Locale默认抛boost::locale::conv::conversion_error,建议捕获处理
  • 字符串末尾的\0需手动清理,避免二进制数据混入

不复杂但容易忽略

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

257

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

208

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

619

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

550

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

545

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

161

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

81

2025.08.07

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.2万人学习

Git 教程
Git 教程

共21课时 | 2.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号