std::wstring_convert
来自cppreference.com
| 在标头 <locale> 定义
|
||
| template< class Codecvt, |
(C++11 起) (C++17 中弃用) (C++26 中移除) |
|
类模板 std::wstring_convert 用单独的编码转换刻面 Codecvt，进行字节字符串 std::string 和宽字符串 std::basic_string<Elem> 间的转换。std::wstring_convert 假定拥有转换刻面的所有权，而不能使用本地环境所管理的刻面。适用于 std::wstring_convert 的标准刻面对于 UTF-8/UCS2 和 UTF-8/UCS4 转换是 std::codecvt_utf8，而对于 UTF-8/UTF-16 转换是 std::codecvt_utf8_utf16。
成员类型
| 成员类型 | 定义 |
byte_string
|
std::basic_string<char, char_traits<char>, Byte_alloc>
|
wide_string
|
std::basic_string<Elem, char_traits<Elem>, Wide_alloc>
|
state_type
|
Codecvt::state_type
|
int_type
|
wide_string::traits_type::int_type
|
成员函数
构造新的 wstring_convert (公开成员函数) | |
| operator= |
复制赋值运算符被弃置 (公开成员函数) |
析构 wstring_convert 及其转换刻面 (公开成员函数) | |
| 转换字节字符串为宽字符串 (公开成员函数) | |
| 转换宽字符串为字符串 (公开成员函数) | |
| 返回成功转换的字符数 (公开成员函数) | |
| 返回当前转换状态 (公开成员函数) |
参阅
| 字符转换 | 本地环境定义的多字节 (UTF-8, GB18030) |
UTF-8 |
UTF-16 |
|---|---|---|---|
| UTF-16 | mbrtoc16 / c16rtomb(有 C11 的 DR488) |
codecvt<char16_t,char,mbstate_t> |
不适用 |
| UCS-2 | c16rtomb(无 C11 的 DR488) | codecvt_utf8<char16_t> | codecvt_utf16<char16_t> |
| UTF-32 |
codecvt<char32_t,char,mbstate_t> |
codecvt_utf16<char32_t> | |
| 系统宽 wchar_t:
UTF-32 (非 Windows) |
mbsrtowcs / wcsrtombs |
codecvt_utf8<wchar_t> | codecvt_utf16<wchar_t> |
| (C++11)(C++17 中弃用)(C++26 中移除) |
进行字节流缓冲区和宽流缓冲区间的转换 (类模板) |
| (C++11)(C++17 中弃用)(C++26 中移除) |
在 UTF-8 与 UCS-2/UCS-4 间转换 (类模板) |
| (C++11)(C++17 中弃用)(C++26 中移除) |
在 UTF-8 与 UTF-16 间转换 (类模板) |