std::basic_format_arg<Context>::handle

 

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)

 

格式化庫

標準格式規範

格式化函式

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

格式字串

basic_format_stringformat_stringwformat_string (C++20 起)(C++20 起)(C++20 起)

runtime_format (C++26)

格式化概念

formattable (C++23)

Formatter

formatter (C++20)

formatter<pair-or-tuple> (C++23)

formatter<range> (C++23)

range_formatter (C++23)

enable_nonlocking_formatter_optimization (C++23)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20 起)(C++20 起)(C++20 起)

basic_format_contextformat_contextwformat_context (C++20 起)(C++20 起)(C++20 起)

range_format (C++23)

format_kind (C++23)

格式化引數

basic_format_arg (C++20)

basic_format_arg::handle (C++20)

basic_format_argsformat_argswformat_args (C++20 起)(C++20 起)(C++20 起)

visit_format_arg (C++20) (在 C++26 中廢棄)

make_format_argsmake_wformat_args (C++20 起)(C++20 起)

格式錯誤

format_error (C++20)

 

定義於標頭檔案 <format>
template< class Context > class basic_format_arg<Context>::handle;		(C++20 起)

一個型別擦除的包裝器，允許格式化使用者定義型別的物件。

handle 物件通常由 std::make_format_args 建立，並透過 std::visit_format_arg 或 std::basic_format_arg 的 visit 成員函式訪問(C++26 起)。

資料成員

handle 的典型實現是 可平凡複製的（TriviallyCopyable），並且只儲存兩個非靜態資料成員

• 一個 const void* 指標，指向要格式化的物件，以及
• 一個 void (*)(std::basic_format_parse_context<Context::char_type>&, Context&, const void*) 函式指標，指向在 format 成員函式中執行所需操作的函式（見下文）。

成員函式

format (C++20)

用給定上下文格式化被引用的物件 (公開成員函式)

std::basic_format_arg<Context>::handle::format

void format( std::basic_format_parse_context<Context::char_type>& parse_ctx,              Context& format_ctx ) const;		(C++20 起)

令

• T 是格式化引數的型別，
• TD 是 std::remove_const_t<T>，
• 如果 const TD 滿足 __formattable_with<Context>，則 TQ 是 const TD，否則是 TD，以及
• ref 是對格式化引數的引用。

等價於：typename Context::template formatter_type<TD> f;
parse_ctx.advance_to(f.parse(parse_ctx));
format_ctx.advance_to(f.format(const_cast<TQ&>(static_cast<const TD&>(ref)), format_ctx));

注意

handle 對格式化引數具有引用語義，並且不會延長其生命週期。確保引數的生命週期長於 handle 是程式設計師的責任。通常，handle 僅在格式化函式內部使用。

另請參閱

basic_format_arg (C++20)	為使用者定義格式化器提供格式化引數訪問的類模板 (類模板)
make_format_argsmake_wformat_args (C++20 起)(C++20 起)	建立引用所有格式化引數的型別擦除物件，可轉換為 format_args (函式模板)