C++ 名前付き要件: UnformattedOutputFunction

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

C++ 名前付き要件

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 型のプロパティ ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType ライブラリワイド BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) アロケータ FunctionObject Callable Predicate BinaryPredicate Compare

コンテナ コンテナ 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) イテレータ LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) ストリームI/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction フォーマッタ BasicFormatter (C++20) フォーマッタ (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)

 

要件

A UnformattedOutputFunction は、以下の操作を行うストリーム出力関数です。

1) 自動記憶域期間を持つ basic_ostream::sentry 型のオブジェクトを構築します。このオブジェクトは以下の操作を行います。

• 出力ストリームで eofbit または badbit が設定されている場合、failbit も設定します。そして、この出力ストリームの 例外マスク で failbit に対する例外が有効になっている場合（(exceptions() & failbit) != 0）、ios_base::failure をスローします。
• 該当する場合、tie()'d されている出力ストリームをフラッシュします。

2) sentry::operator bool() を呼び出して sentry の状態をチェックします。これは basic_ios::good と同等です。

• 演算子 が false を返すか、sentry のコンストラクタが例外をスローした場合、出力は行われません。
• 演算子 が true を返す場合、rdbuf()->sputc() を呼び出すかのように、目的の出力を実行しようとします。 std::basic_ostream のその他のパブリックメンバも使用される可能性がありますが、rdbuf() の仮想メンバのうち overflow()、xsputn()、および sync() 以外が呼び出されることはありません。

• 出力中に例外がスローされた場合、出力ストリームに badbit を設定します。このストリームの 例外マスク で badbit に対する例外が有効になっている場合（(exceptions() & badbit) != 0）、例外も再スローされます。
• 例外がスローされなかった場合、関数によって指定された値を返します。

3) いずれの場合も、例外による終了または戻りにかかわらず、この関数を離れる前に sentry のデストラクタが呼び出されます。

標準ライブラリ

以下の標準ライブラリ関数は UnformattedOutputFunction です。

• basic_ostream::operator<<(basic_streambuf*)
• basic_ostream::put
• basic_ostream::write
• basic_ostream::flush

basic_ostream::tellp (出力の代わりに pubseekoff を呼び出す場合) basic_ostream::seekp (出力の代わりに pubseekoff または pubseekpos を呼び出す場合)

(C++11以降)

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 63	C++98	例外処理ポリシーが欠落していました	追加された
LWG 160	C++98	キャッチされた例外が 再スローされるかどうかを決定するプロセスで、存在しない関数 `exception()` に言及していましたが、	exceptions() に修正されました。
LWG 165	C++98	呼び出しが許可される仮想メンバは rdbuf() の overflow() のみでした	も許可 xsputn() および sync()