讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何将UTF-8转换为UTF-16

小枫小哥_5608

小枫小哥_5608

发布时间:2026-08-01 18:34:25

|

630人浏览过

|

来源于php中文网

原创

std::wstring_convert在C++17中被移除,因其自C++11起已被弃用;替代方案为Windows平台使用MultiByteToWideChar,跨平台推荐utf8cpp库,而std::codecvt_utf8_utf16虽存在但已弃用且问题多。

c++如何将utf-8转换为utf-16

UTF-8转UTF-16时,std::wstring_convert为什么不能用了?

因为C++17起,std::wstring_convert和std::wbuffer_convert已被移除(deprecated in C++11, removed in C++17)。现在直接用它们会编译失败,不是你代码写错,是标准库砍掉了。别查旧教程硬套,得换路子。

主流替代方案就两条:用平台API(Windows用MultiByteToWideChar,Linux/macOS靠iconv或第三方库),或者引入轻量级UTF处理库如utf8cpp。自己手写转换逻辑不现实——边界条件太多,容易漏掉代理对、过长序列、非法字节。

Windows下最稳的转换方式:用MultiByteToWideChar

这是Windows原生API,零依赖、性能好、处理BOM和错误码都可控。关键点不是调两次,而是第一次传nullptr获取长度,第二次填目标缓冲区。

  • CP_UTF8必须作为CodePage参数,别写成CP_ACP或0
  • 输入const char*必须以\0结尾,否则MultiByteToWideChar可能读越界
  • 返回值是wchar_t个数(不含\0),不是字节数;分配std::vector<wchar_t>(len + 1)</wchar_t>再加\0更安全
  • 如果输入含非法UTF-8序列,默认会失败(返回0);加MB_ERR_INVALID_CHARS标志可让其报错,不加则静默替换为U+FFFD

示例片段:

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

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
int len = MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, nullptr, 0);
if (len == 0) return L"";
std::vector<wchar_t> buf(len);
MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, buf.data(), len);
return std::wstring(buf.data());

跨平台方案:用utf8cpp库一行搞定

头文件只有utf8.h,无编译依赖,适合嵌入式或不想绑死平台的项目。它不处理BOM,也不自动检测编码,纯按UTF-8规则转码。

  • 输入必须是合法UTF-8,否则utf8::utf8to16行为未定义(可能崩溃或截断)
  • 输出是std::u16string,不是std::wstring;Windows上sizeof(wchar_t) == 2,二者等价;Linux/macOS上wchar_t是4字节,不能直接赋值
  • 若需std::wstring,且目标平台wchar_t为2字节(如MSVC),可强制转型:std::wstring(reinterpret_cast<const wchar_t>(u16str.data()), u16str.size())</const>
  • 注意utf8::utf8to16返回的是std::u16string,别误当成std::string去.c_str()

调用示例:

#include "utf8.h"
std::u16string utf16 = utf8::utf8to16(utf8_str);

为什么std::codecvt_utf8_utf16也不推荐?

它还在标准库里,但被标记为deprecated(C++17),且实际使用陷阱多:

  • 必须配合std::wbuffer_convert(已移除)或自定义流缓冲区,代码冗长
  • 不同编译器实现差异大:GCC libstdc++里它不支持std::wstring直接转换,Clang libc++部分版本有bug
  • 无法控制错误处理策略(比如遇到非法序列是抛异常还是跳过),灵活性差
  • 性能比原生API或utf8cpp低一截,因为绕了IO流抽象层

除非维护非常老的C++11代码且不能升级,否则别碰它。

真正要小心的是:UTF-8字符串是否真的合法、wchar_t在目标平台是否真代表UTF-16、以及BOM要不要保留——这三个点没理清,转出来的东西看着像,用起来就崩。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2248

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1019

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

427

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

406

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

580

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1409

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1217

2024.03.22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn