std::codecvt_utf8_utf16

定义在头文件 `<codecvt>` 中
template< class Elem, unsigned long Maxcode = 0x10ffff, std::codecvt_mode Mode = (std::codecvt_mode)0 > class codecvt_utf8_utf16 : public std::codecvt<Elem, char, std::mbstate_t>;		(自 C++11 起) (在 C++17 中已弃用) (在 C++26 中已删除)

std::codecvt_utf8_utf16 是一个 std::codecvt 刻面，它封装了在 UTF-8 编码字节字符串和 UTF-16 编码字符字符串之间的转换。如果 Elem 是一个 32 位类型，则一个 UTF-16 代码单元将存储在输出序列的每个 32 位字符中。

这是一个 N:M 转换刻面，不能与 std::basic_filebuf 一起使用（它只允许 1:N 转换，例如 UTF-32/UTF-8，在内部编码和外部编码之间）。该刻面可与 std::wstring_convert 一起使用。

内容

1 模板参数
2 成员函数
3 std::codecvt_utf8_utf16::codecvt_utf8_utf16
- 3.1 参数
4 std::codecvt_utf8_utf16::~codecvt_utf8_utf16
5 从 std::codecvt 继承而来
6 从 std::codecvt_base 继承而来
- 6.1 示例
- 6.2 另请参见

[编辑] 模板参数

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` (static)	std::locale::id

成员函数

out	调用 `do_out` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
in	调用 `do_in` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
unshift	调用 `do_unshift` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
encoding	调用 `do_encoding` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
always_noconv	调用 `do_always_noconv` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
length	调用 `do_length` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]
max_length	调用 `do_max_length` (`std::codecvt<InternT,ExternT,StateT>` 的公有成员函数) [编辑]

受保护的成员函数

do_out [virtual]	将字符串从 `InternT` 转换为 `ExternT`，例如在写入文件时 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_in [virtual]	将字符串从 `ExternT` 转换为 `InternT`，例如在从文件读取时 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_unshift [virtual]	为不完整的转换生成 `ExternT` 字符的终止字符序列 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_encoding [virtual]	如果为常量，则返回生成一个 `InternT` 字符所需的 `ExternT` 字符数 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_always_noconv [virtual]	测试该刻面是否为所有有效参数值编码标识转换 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_length [virtual]	计算将被转换为给定 `InternT` 缓冲区的 `ExternT` 字符串的长度 (`std::codecvt<InternT,ExternT,StateT>` 的虚拟受保护成员函数) [编辑]
do_max_length [virtual]	返回可以转换为单个`InternT`字符的最多`ExternT`字符数 (`std::codecvt<InternT,ExternT,StateT>`的虚拟受保护成员函数) [编辑]

继承自std::codecvt_base

成员类型	定义
enum result { ok, partial, error, noconv };	无作用域枚举类型

枚举常量	定义
`ok`	转换已完成，没有错误
`partial`	并非所有源字符都被转换
`error`	遇到无效字符
`noconv`	不需要转换，输入和输出类型相同

[编辑] 示例

运行此代码

#include <cassert>
#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
 
int main()
{
    std::string u8 = "z\u00df\u6c34\U0001f34c";
    std::u16string u16 = u"z\u00df\u6c34\U0001f34c";
 
    // UTF-8 to 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" << std::showbase << std::hex;
    for (char16_t c : u16_conv)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
 
    // UTF-16/char16_t to 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 << +static_cast<unsigned char>(c) << ' ';
    std::cout << '\n';
}

输出

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
UCS-2	`c16rtomb` (不使用 C11 的 DR488)	`codecvt_utf8`<char16_t>	`codecvt_utf16`<char16_t>
UTF-32	`mbrtoc32` / `c32rtomb`	`codecvt`<char32_t,char,mbstate_t> `codecvt_utf8`<char32_t>	`codecvt_utf16`<char32_t>
系统 wchar_t UTF-32 (非 Windows) UCS-2 (Windows)	`mbsrtowcs` / `wcsrtombs` `use_facet`<`codecvt` <wchar_t,char,mbstate_t>>(`locale`)	`codecvt_utf8`<wchar_t>	`codecvt_utf16`<wchar_t>

codecvt	在字符编码之间进行转换，包括 UTF-8、UTF-16、UTF-32 (类模板) [编辑]
codecvt_mode (C++11)(C++17 中已弃用)(在 C++26 中删除)	用于更改标准 codecvt 方面行为的标记 (枚举) [编辑]
codecvt_utf8 (C++11)(C++17 中已弃用)(在 C++26 中删除)	在 UTF-8 和 UCS-2/UCS-4 之间进行转换 (类模板) [编辑]
codecvt_utf16 (C++11)(C++17 中已弃用)(在 C++26 中删除)	在 UTF-16 和 UCS-2/UCS-4 之间进行转换 (类模板) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

字符转换
toupper
tolower
字符串和流转换
wstring_convert (C++11/17/26*)
wbuffer_convert (C++11/17/26*)

cppreference.com

命名空间

变体

视图

操作