std::text_encoding::text_encoding

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库 (C++11)

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

初等数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (C++26)

 

std::text_encoding

成员函数

创建

text_encoding::text_encoding

text_encoding::literal

text_encoding::environment

观察器

text_encoding::mib

text_encoding::name

text_encoding::aliases

text_encoding::environment_is

辅助函数

text_encoding::comp-name

非成员函数

operator==(std::text_encoding)

成员类型

text_encoding::id

text_encoding::aliases_view

辅助类

hash<std::text_encoding>

 

constexpr text_encoding() = default;	(1)	(C++26 起)
constexpr explicit text_encoding( std::string_view enc ) noexcept;	(2)	(C++26 起)
constexpr text_encoding( std::text_encoding::id i ) noexcept;	(3)	(C++26 起)

构造一个新文本编码对象。

1) 默认构造函数。构造一个带有 MIBenum 值 std::text_encoding::id::unknown 和空字符编码名称的对象。

2) 构造一个字符编码名称为 enc 的对象。

如果 enc 指名了除 NATS-DANO 或 NATS-DANO-ADD 以外的注册字符编码，那么所构造的对象会有对应的 MIBenum 值，否则它会有 MIBenum 值 std::text_encoding::id::other。

若 enc.size() > std::text_encoding::max_name_length || enc.contains('\0') 则其行为未定义。

3) 构造一个 MIBenum 值为 i 的对象。

如果 i 为 std::text_encoding::id::other 或 std::text_encoding::id::unknown，那么所构造的对象会有空的字符编码名称，否则它会有其对应名称之一的名称。

若 i 不是 std::text_encoding::id 的一个具名枚举项，则其行为未定义。

Parameters

enc	-	字符编码名称
i	-	MIBenum 值

示例

View on Compiler Explorer.

运行此代码

#include <text_encoding>
 
int main()
{
    constexpr std::text_encoding iso60 = std::text_encoding::ISO60DanishNorwegian;
    static_assert(iso60 == std::text_encoding("csISO60DanishNorwegian"));
    static_assert(iso60 == std::text_encoding("iso-ir-60"));
    static_assert(iso60 == std::text_encoding("NS_4551-1"));
}

外部链接

IANA 字符集名称与 MIBenum 值注册表。