std::text_encoding::literal

 

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>

 

static consteval text_encoding literal() noexcept;		(since C++26)

构造一个新的 text_encoding 对象，表示普通字符字面量编码。它用于确定应用于普通字符或字符串字面量（例如 "This is literal"）的字符编码。

除非 CHAR_BIT 为 8，否则此函数将被删除。

参数

(无)

返回值

持有普通字面量编码表示的对象。

注解

此函数可以通过使用编译器特定的内置宏（例如 Clang 的 __clang_literal_encoding__ 或 GCC 的 __GNUC_EXECUTION_CHARSET_NAME）构造 text_encoding 来实现。这些宏在编译时已知，会扩展为包含所用窄执行字符集名称（普通字面量编码）的窄字符串字面量。

literal() 返回的值可能取决于编译器选项，例如 GCC 或 Clang 中的 -fexec-charset=encoding-name 或 MSVC 中的 /execution-charset:encoding-name。

示例

此示例演示了普通字面量编码应为 UTF-8 的断言。

运行此代码

#include <text_encoding>
 
static_assert(std::text_encoding::literal() == std::text_encoding::UTF8);
 
int main()
{
    // if the literal encoding is UTF-8, then this unprefixed string literal is
    // encoded as UTF-8
    constexpr char green_heart[] = "\N{GREEN HEART}";
 
    // this prefixed string literal is always encoded as UTF-8 regardless of the
    // literal encoding
    constexpr char8_t green_heart_u8[] = u8"\N{GREEN HEART}";
}