std::text_encoding::literal

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (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;		(C++26 起)

構造一個表示普通字元字面量編碼的新的text_encoding物件。它用於確定應用於普通字元或字串字面量（例如"This is literal"）的字元編碼。

除非CHAR_BIT為8，否則此函式被刪除。

引數

(無)

返回值

持有普通字面量編碼表示的物件。

注意

此函式可以透過使用編譯器特定的內建宏來構造text_encoding，例如Clang的__clang_literal_encoding__或GCC的__GNUC_EXECUTION_CHARSET_NAME。這些在編譯時已知的宏，會擴充套件為一個窄字串字面量，其中包含所使用的窄執行字元集（普通字面量編碼）的名稱。

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}";
}