std::codecvt_utf8_C++中文网
C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- std::locale
- std::use_facet
- std::has_facet
- std::isspace(std::locale)
- std::isblank(std::locale)
- std::codecvt
- std::wstring_convert
- std::iscntrl(std::locale)
- std::isupper(std::locale)
- std::islower(std::locale)
- std::isalpha(std::locale)
- std::isdigit(std::locale)
- std::ispunct(std::locale)
- std::isxdigit(std::locale)
- std::isalnum(std::locale)
- std::isprint(std::locale)
- std::isgraph(std::locale)
- std::toupper(std::locale)
- std::tolower(std::locale)
- std::wbuffer_convert
- std::ctype_base
- std::codecvt_base
- std::messages_base
- std::time_base
- std::money_base
- std::ctype
- std::ctype<char>
- std::collate
- std::messages
- std::time_get
- std::time_put
- std::num_get
- std::num_put
- std::numpunct
- std::money_get
- std::money_put
- std::moneypunct
- std::ctype_byname
- std::codecvt_byname
- std::messages_byname
- std::collate_byname
- std::time_get_byname
- std::time_put_byname
- std::numpunct_byname
- std::moneypunct_byname
- std::codecvt_utf8
- std::codecvt_utf16
- std::codecvt_utf8_utf16
- std::codecvt_mode
- std::setlocale
- std::localeconv
- std::lconv
- LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC, LC_TIME
- 注释
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
class Elem,
unsigned long Maxcode = 0x10ffff,
std::codecvt_mode Mode = (std::codecvt_mode)0
> class codecvt_utf8 : public std::codecvt<Elem, char, std::mbstate_t>;
(C++17 中弃用)
std::codecvt_utf8 是封装 UTF-8 编码字符串和 UCS2 或 UTF-32 字符串（取决于 Elem 类型）间转换的 std::codecvt 平面。此 codecvt 能用于读写文本和二进制的 UTF-8 文件。
模板形参
| Elem | - | char16_t 、 char32_t 或 wchar_t 之一 |
| Maxcode | - | 此平面将读写而无错误的最大 Elem 值
|
| Mode | - | std::codecvt_mode 类型常量 |
成员函数
构造新的 codecvt_utf8 平面 (公开成员函数) | |
销毁 codecvt_utf8 平面 (公开成员函数) |
std::codecvt_utf8::codecvt_utf8
构造新的 std::codecvt_utf8 平面，传递初始引用计数 refs 给基类。
参数
std::codecvt_utf8::~codecvt_utf8
销毁平面。不同于 locale 管理的平面，此平面的析构函数是公开的。
继承自 std::codecvt
成员类型
| 成员类型 | 定义 |
intern_type
|
internT
|
extern_type
|
externT
|
state_type
|
stateT
|
成员对象
成员函数
调用 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
|
不要求转换，输入与输出类型相同 |
注意
尽管标准要求此版面在 Elem 为 16 位时用 UCS2 工作，某些实现用 UTF-16 代替。用语 "UCS2" 已被弃用并被移除 Unicode 标准。
示例
下例示例演示 UCS2/UTF-8 间和 UTF-16/UTF-8 间转换的差异：字符串中的字符不是合法的 UCS2 字符。
输出：
UTF16 conversion produced 4 code units: 0x7a 0x6c34 0xd834 0xdd0b UCS2 failed after producing 2 characters: 0x7a 0x6c34
参阅
| 字符转换 | 本地环境定义多字节 (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 |
无 | 无 |