C++ 命名要求： FormattedOutputFunction

 

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)

 

要求

FormattedOutputFunction 是執行以下操作的流輸出函式：

• 構造一個具有自動儲存期的 basic_ostream::sentry 型別物件，該物件執行以下操作：

• 如果輸出流上設定了 eofbit 或 badbit，則也設定 failbit，並且如果此輸出流的 異常掩碼 中啟用了 failbit 上的異常（(exceptions() & failbit) != 0），則丟擲 ios_base::failure。
• 如果適用，重新整理 tie() 的輸出流。

• 透過呼叫 sentry::operator bool() 檢查崗哨的狀態，這等效於 basic_ios::good。
• 如果崗哨返回 false 或崗哨的建構函式丟擲異常，則不進行輸出。
• 如果崗哨返回 true，則嘗試透過將字元插入輸出流來執行所需的輸出，如同透過呼叫 rdbuf()->sputc()。還可以使用 std::basic_ostream 的其他公共成員，但除了 overflow()、xsputn() 和 sync() 之外，rdbuf() 的虛成員永遠不會被呼叫。

• 如果無法生成輸出，則設定 failbit。如果此流的 異常掩碼 中啟用了 failbit 上的異常（(exceptions() & failbit) != 0），則丟擲 ios_base::failure。
• 如果在輸出期間丟擲異常，則在輸出流中設定 badbit。如果此流的 異常掩碼 中啟用了 badbit 上的異常（(exceptions() & badbit) != 0），則該異常也會被重新丟擲。
• 如果沒有丟擲異常，則返回 *this。

• 無論如何，無論是透過異常終止還是返回，崗哨的解構函式都會在此函式退出之前被呼叫。

填充

格式化輸出函式根據 std::num_put::do_put() 階段 3 確定填充。	(直到 C++14)
如果流 os 的格式化輸出函式確定填充，它將按如下方式進行。 給定一個 CharT 字元序列 seq，其中 CharT 是 os 的 字元容器型別，如果 seq 的長度小於 os.width()，則根據需要向此序列新增足夠多的 os.fill() 副本，以填充到 os.width() 個字元的寬度。 如果 (os.flags() & std::ios_base::adjustfield) == std::ios_base::left 為 true，則填充字元放置在字元序列之後；否則，它們放置在字元序列之前。	(C++14 起)

標準庫

以下標準庫函式是 FormattedOutputFunctions。

• basic_ostream::operator<<(std::basic_ostream&, int / long / double / void* / bool)
• operator<<(std::basic_ostream&, char)
• operator<<(std::basic_ostream&, char*)
• operator<<(std::basic_ostream&, const std::bitset&)
• operator<<(std::basic_ostream&, const std::basic_string&)
• operator<< ，當對 std::put_money 的返回值呼叫時

operator<<(std::basic_ostream&, std::basic_string_view)

(C++17 起)

print(std::ostream&, std::format_string<Args...>, Args&&...), println(std::ostream&, std::format_string<Args...>, Args&&...), vprint_unicode(std::ostream&, std::string_view, std::format_args), vprint_nonunicode(std::ostream&, std::string_view, std::format_args), 但（給定 os 是一個輸出流物件） 呼叫 std::vformat 丟擲的任何異常都會被傳播，而不管 os.exceptions() 的值，並且不會在 os 的錯誤狀態中開啟 ios_base::badbit； 如果插入 os 失敗，則呼叫 os.setstate(ios_base::badbit)（這可能會丟擲 ios_base::failure）。

(C++23 起)

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 160	C++98	確定捕獲的異常是否重新丟擲的過程 提到了一個不存在的函式 exception()	更正為 exceptions()
LWG 165	C++98	唯一允許對 rdbuf() 呼叫的虛成員是 overflow()	也允許 xsputn() 和 sync()