std::codecvt_utf8_utf16
来自cppreference.com
| 定义于头文件 <codecvt>
|
||
| template< class Elem, unsigned long Maxcode = 0x10ffff, |
(C++11 起) (C++17 中弃用) |
|
std::codecvt_utf8_utf16 是一个 std::codecvt 平面，封装 UTF-8 编码字节串和 UTF-16 编码字符串间的转换。若 Elem 为 32 位类型，则输出序列的每个 32 位字符中将存储一个 UTF-16 编码单元。
这是 N:M 转换平面，而且不能为 std::basic_filebuf 所用（它只容许内部和外部编码间的 1:N 转换，例如 UTF-32/UTF-8 ）。此平面不能为 std::wstring_convert 所用。
模板形参
| Elem | - | char16_t 、 char32_t 或 wchar_t 之一 |
| Maxcode | - | 此平面将读或写而不出错的 Elem 最大值
|
| Mode | - | std::codecvt_mode 类型常量 |
成员函数
| (构造函数) |
构造新的 codecvt_utf8_utf16 平面 (公开成员函数) |
| (析构函数) |
销毁 codecvt_utf8_utf16 平面 (公开成员函数) |
std::codecvt_utf8_utf16::codecvt_utf8_utf16
| explicit codecvt_utf8_utf16( std::size_t refs = 0 ); |
||
构造新的 std::codecvt_utf8_utf16 平面，传递初始引用计数 refs 给基类。
参数
| refs | - | 链接到平面的引用数 |
std::codecvt_utf8_utf16::~codecvt_utf8_utf16
| ~codecvt_utf8_utf16(); |
||
销毁平面。不同于本地环境所管理的平面，此平面的析构函数为公开。
继承自 std::codecvt
成员类型
| 成员类型 | 定义 |
intern_type
|
internT
|
extern_type
|
externT
|
state_type
|
stateT
|
成员对象
| 成员名 | 类型 |
id [静态]
|
std::locale::id |
成员函数
调用 do_out ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_in ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_unshift ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_encoding ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_always_noconv ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_length ( std::codecvt<InternT,ExternT,State> 的公开成员函数) | |
调用 do_max_length ( std::codecvt<InternT,ExternT,State> 的公开成员函数) |
受保护成员函数
| [虚] |
从 internT 转换字符串为 externT 转换字符串，如在写入文件时 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
| [虚] |
从 externT 转换字符串为 internT ，如在从文件读取时 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
| [虚] |
为不完整转换生成 externT 字符的终止字符序列 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
| [虚] |
返回产生一个 internT 字符所需的 externT 字符数，若此值为常数 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
| 测试平面编码是否对所有合法值为恒等转换 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) | |
| [虚] |
计算转换成给定的 internT 缓冲区会消耗的 externT 字符串长度 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
| 返回能转换成单个 internT 字符的最大 externT 字符数 ( std::codecvt<InternT,ExternT,State> 的虚受保护成员函数) |
继承自 std::codecvt_base
| 成员类型 | 定义 |
| enum result { ok, partial, error, noconv }; | 无作用域枚举类型 |
| 枚举常量 | 定义 |
ok
|
完成转换而无错误 |
partial
|
未转换所有源字符 |
error
|
遇到非法字符 |
noconv
|
不要求转换，输入与输出类型相同 |
示例
运行此代码
#include <iostream> #include <string> #include <codecvt> #include <cassert> #include <locale> int main() { std::string u8 = u8"z\u00df\u6c34\U0001f34c"; std::u16string u16 = u"z\u00df\u6c34\U0001f34c"; // UTF-8 到 UTF-16/char16_t std::u16string u16_conv = std::wstring_convert< std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(u8); assert(u16 == u16_conv); std::cout << "UTF-8 to UTF-16 conversion produced " << u16_conv.size() << " code units:\n"; for (char16_t c : u16_conv) std::cout << std::hex << std::showbase << c << ' '; // UTF-16/char16_t 到 UTF-8 std::string u8_conv = std::wstring_convert< std::codecvt_utf8_utf16<char16_t>, char16_t>{}.to_bytes(u16); assert(u8 == u8_conv); std::cout << "\nUTF-16 to UTF-8 conversion produced " << std::dec << u8_conv.size() << " bytes:\n" << std::hex; for (char c : u8_conv) std::cout << +(unsigned char)c << ' '; }
输出：
UTF-8 to UTF-16 conversion produced 5 code units: 0x7a 0xdf 0x6c34 0xd83c 0xdf4c UTF-16 to UTF-8 conversion produced 10 bytes: 0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c
参阅
| 字符转换 | 本地环境定义多字节 (UTF-8, GB18030) |
UTF-8 |
UTF-16 |
|---|---|---|---|
| UTF-16 | mbrtoc16 / c16rtomb(有 C11 的 DR488) | codecvt<char16_t, char, mbstate_t> codecvt_utf8_utf16<char16_t> codecvt_utf8_utf16<char32_t> codecvt_utf8_utf16<wchar_t> |
N/A |
| UCS2 | c16rtomb(无 C11 的 DR488) | codecvt_utf8<char16_t> codecvt_utf8<wchar_t>(Windows) |
codecvt_utf16<char16_t> codecvt_utf16<wchar_t>(Windows) |
| UTF-32 |
codecvt<char32_t, char, mbstate_t> |
codecvt_utf16<char32_t> | |
| 系统宽 UTF-32(非 Windows) UCS2(Windows) |
mbsrtowcs / wcsrtombs |
无 | 无 |
| 在字符编码间转换，包括 UTF-8、UTF-16、UTF-32 (类模板) | |
| (C++11)(C++17 中弃用) |
用于改变标准 codecvt 刻面行为的标签 (枚举) |
| (C++11)(C++17 中弃用) |
在 UTF-8 与 UCS2/UCS4 间转换 (类模板) |
| (C++11)(C++17 中弃用) |
在 UTF-16 与 UCS2/UCS4 间转换 (类模板) |
