C++如何将宽字符wstring转string_C++ codecvt与字符编码转换-C++-PHP中文网

C++如何将宽字符wstring转string_C++ codecvt与字符编码转换

尼克

发布： 2025-11-25 17:25:02

原创

641人浏览过

答案：C++中wstring转string需进行编码转换，常用std::wstring_convert与codecvt_utf8（C++11-14），但该方法在C++17后被弃用；Windows平台推荐WideCharToMultiByte实现高效转换；现代C++建议使用Boost.Locale或ICU等第三方库以确保兼容性与可维护性。

c++如何将宽字符wstring转string_c++ codecvt与字符编码转换

在C++中将宽字符字符串（wstring）转换为普通字符串（string），本质上是进行字符编码的转换，通常是将UTF-16（Windows上wchar_t的常见编码）或UTF-32转为UTF-8或本地多字节编码（如GBK）。C++标准库提供了std::codecvt相关的facet来实现这类转换，尽管部分功能在C++17后被弃用，但在许多现有项目中仍广泛使用。

使用 std::wstring_convert 与 codecvt_utf8（C++11 到 C++14）

在C++11到C++14中，std::wstring_convert 和 std::codecvt_utf8 是最常用的组合，用于在 wstring 和 string 之间转换UTF-8编码。

注意：wstring_convert 和 codecvt 在 C++17 中被弃用，在 C++20 中移除。但如果你使用的是较早的标准（如 C++14），以下方法依然有效。

示例代码：

#include <iostream>
#include <string>
#include <locale>
#include <codecvt>

int main() {
    std::wstring wstr = L"Hello 世界"; // 宽字符字符串

    // 创建转换器：从 wide string 转 UTF-8 string
    std::wstring_convert<std::codecvt_utf8<wchar_t>> converter;
    std::string str = converter.to_bytes(wstr);

    std::cout << str << std::endl; // 输出: Hello 世界

    // 反向转换
    std::wstring wstr2 = converter.from_bytes(str);
    return 0;
}

登录后复制

说明：

立即学习“C++免费学习笔记（深入）”；

std::codecvt_utf8<wchar_t> 处理 wchar_t 类型的宽字符到 UTF-8 字节序列的转换。
std::wstring_convert 是一个便捷类，封装了编码转换逻辑。
该方法适用于跨平台场景，只要系统支持 UTF-8。

替代方案：手动使用 codecvt facet（更底层控制）

如果不使用 wstring_convert，可以直接使用 std::codecvt facet 进行转换，这提供更精细的控制。

示例：

v0.dev

Vercel推出的AI生成式UI工具，通过文本描述生成UI组件代码

261

查看详情

#include <locale>
#include <codecvt>
#include <iostream>

int main() {
    std::wstring wstr = L"测试 Test";

    // 获取本地环境中的 codecvt facet
    std::wstring_convert<std::codecvt_utf8<wchar_t>, wchar_t> conv;
    std::string utf8 = conv.to_bytes(wstr);

    std::wcout << L"原始宽字符串: " << wstr << std::endl;
    std::cout << "UTF-8 编码: " << utf8 << std::endl;

    return 0;
}

登录后复制

Windows 平台专用：WideCharToMultiByte

在 Windows 上，推荐使用 Win32 API WideCharToMultiByte，它更稳定、高效，并且不受 C++标准变更影响。

示例（转换为 UTF-8）：

#include <windows.h>
#include <string>
#include <iostream>

std::string wstring_to_utf8(const std::wstring& wstr) {
    if (wstr.empty()) return {};
    int size_needed = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), nullptr, 0, nullptr, nullptr);
    std::string str(size_needed, 0);
    WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), &str[0], size_needed, nullptr, nullptr);
    return str;
}

int main() {
    std::wstring wstr = L"Hello 中国";
    std::string utf8 = wstring_to_utf8(wstr);
    std::cout << utf8 << std::endl;
    return 0;
}

登录后复制

优点：

不受 C++标准弃用影响。
可指定目标编码（如 CP_UTF8、CP_ACP 等）。
性能更好，适合高频调用场景。

现代 C++ 推荐做法（C++17 及以后）

由于 wstring_convert 被弃用，现代 C++ 项目建议使用第三方库或平台原生API：

ICU (International Components for Unicode)：功能强大，支持多种编码和国际化操作。
Boost.Locale：基于 ICU 封装，使用简单，兼容性好。
std::u8string / std::u16string：C++20 引入了更多 Unicode 字符串类型，未来趋势是使用 char8_t 等类型明确编码语义。

例如使用 Boost.Locale：

#include <boost/locale.hpp>
#include <iostream>

int main() {
    std::wstring wstr = L"测试字符串";
    std::string utf8 = boost::locale::conv::to_utf << wstr;
    std::cout << utf8 << std::endl;
    return 0;
}

登录后复制

基本上就这些。根据你的编译器版本和目标平台选择合适的方法。对于新项目，优先考虑 Boost 或平台API；老项目可继续使用 codecvt 相关组件，但需注意迁移计划。

以上就是C++如何将宽字符wstring转string_C++ codecvt与字符编码转换的详细内容，更多请关注php中文网其它相关文章！