C++ 命名要求： Formatter （C++20 起）

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 命名要求

基本 DefaultConstructible（可預設構造） MoveConstructible（可移動構造） （C++11） CopyConstructible（可複製構造） CopyAssignable（可複製賦值） MoveAssignable（可移動賦值） （C++11） Destructible（可析構） 型別屬性 ScalarType（標量型別） PODType（POD型別） TriviallyCopyable（可平凡複製） （C++11） TrivialType（平凡型別） （C++11） StandardLayoutType（標準佈局型別） （C++11）   ImplicitLifetimeType（隱式生命週期型別） 全庫範圍 BooleanTestable（可布林測試） EqualityComparable（可相等比較） LessThanComparable（可小於比較） Swappable（可交換） ValueSwappable（值可交換） （C++11） NullablePointer（可空指標） （C++11） Hash（雜湊） （C++11） 分配器（Allocator） FunctionObject（函式物件） 可呼叫物件（Callable） Predicate（謂詞） BinaryPredicate（二元謂詞） 比較器（Compare）

Container（容器） Container（容器） ReversibleContainer（可逆容器） AllocatorAwareContainer（分配器感知容器） SequenceContainer（序列容器） ContiguousContainer（連續容器） （C++17） AssociativeContainer（關聯容器） UnorderedAssociativeContainer（無序關聯容器） （C++11）   容器元素 DefaultInsertable（可預設插入） （C++11） CopyInsertable（可複製插入） （C++11） MoveInsertable（可移動插入） （C++11） EmplaceConstructible（可就地構造） （C++11） Erasable（可擦除） （C++11） 迭代器 (Iterator) LegacyIterator（傳統迭代器） LegacyInputIterator（傳統輸入迭代器） LegacyOutputIterator（傳統輸出迭代器） LegacyForwardIterator（傳統前向迭代器） LegacyBidirectionalIterator（傳統雙向迭代器） LegacyRandomAccessIterator（傳統隨機訪問迭代器） LegacyContiguousIterator（傳統連續迭代器） （C++17） ConstexprIterator（常量表達式迭代器） （C++20） 流 I/O FormattedInputFunction（格式化輸入函式） UnformattedInputFunction（非格式化輸入函式） FormattedOutputFunction（格式化輸出函式） UnformattedOutputFunction（非格式化輸出函式） 格式化器 BasicFormatter（基本格式化器） （C++20） 格式化器（Formatter） （C++20）

隨機數 SeedSequence（種子序列） （C++11） RandomNumberEngine（隨機數引擎） （C++11） RandomNumberDistribution（隨機數分佈） （C++11） UniformRandomBitGenerator（均勻隨機位元生成器） （C++11） RandomNumberEngineAdaptor（隨機數引擎介面卡） （C++11） 併發 BasicLockable（基本可鎖定） （C++11） Lockable（可鎖定） （C++11） TimedLockable（定時可鎖定） （C++11） SharedLockable（共享可鎖定） （C++14） SharedTimedLockable（共享定時可鎖定） （C++14） 互斥體（Mutex） （C++11） TimedMutex（定時互斥量） （C++11） SharedMutex（共享互斥量） （C++17） SharedTimedMutex（共享定時互斥量） （C++14） 範圍（Ranges） RangeAdaptorObject（範圍介面卡物件） （C++20） RangeAdaptorClosureObject（範圍介面卡閉包物件） （C++20） 多維檢視 LayoutMapping（佈局對映） （C++23） LayoutMappingPolicy（佈局對映策略） （C++23） 訪問器策略（AccessorPolicy） （C++23） 其他 CharTraits（字元特性） RegexTraits（正則表示式特性） （C++11）   BitmaskType（位掩碼型別） LiteralType（字面量型別） （C++11） NumericType（數值型別） UnaryTypeTrait（一元型別特性） （C++11） BinaryTypeTrait（二元型別特性） （C++11） TransformationTrait（轉換特性） （C++11） Clock（時鐘） （C++11） TrivialClock（平凡時鐘） （C++11）

 

Formatter 是一種抽象了給定格式化引數型別和字元型別的格式化操作的型別。標準庫提供的 std::formatter 特化必須滿足 Formatter 的要求，除非另有說明。

Formatter 能夠格式化 const 和非 const 引數，通常透過提供一個接受 const 引用的 format 成員函式。

要求

如果一個型別滿足 BasicFormatter 並且給定以下型別和值，則下表中所示的表示式是有效的並具有指示的語義，則該型別滿足 Formatter

型別	定義
CharT	字元型別
Arg	格式化引數型別
格式化器（Formatter）	用於型別 Arg 和 CharT 的 Formatter 型別
OutputIt	舊版輸出迭代器 型別
ParseCtx	std::basic_format_parse_context<CharT>
FmtCtx	std::basic_format_context<OutputIt, CharT>
值	定義
f	型別為（可能帶有 const 限定符）Formatter 的值
arg	型別為 Arg 的左值
t	可轉換為（可能帶有 const 限定符）Arg 的型別的值
parse_ctx	型別為 ParseCtx 的左值，滿足以下所有條件 parse_ctx.begin() 指向 格式字串 中正在格式化的替換欄位的 format-spec 的開頭。 如果 format-spec 不存在或為空，則 parse_ctx.begin() == parse_ctx.end() 或 *parse_ctx.begin() == '}'。
fmt_ctx	型別為 FmtCtx 的左值

表示式	返回型別	語義
f.format(t, fmt_ctx)	FmtCtx::iterator	根據儲存在 f 中的說明符格式化 t，將輸出寫入 fmt_ctx.out()，並返回輸出範圍的結束迭代器。 輸出只能依賴於 t, fmt_ctx.locale(), 上次呼叫 f.parse(parse_ctx) 得到的範圍 [parse_ctx.begin(), parse_ctx.end())，以及 fmt_ctx.arg(n) 對於任何型別為 std::size_t 的值 n。
f.format(arg, fmt_ctx)	FmtCtx::iterator	如上所述，但不修改 arg。

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 3892	C++20	如果 format-spec 不存在，則 pc.begin() 的值不明確	已明確