C++ 名前付き要件: UnformattedInputFunction

UnformattedInputFunction は、以下の操作を実行するストリーム入力関数です。

1) noskipws 引数を true に設定して、自動記憶域期間を持つ basic_istream::sentry 型のオブジェクトを構築します。これは以下の操作を実行します。

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

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

ストリームの終端に達した場合（rdbuf()->sbumpc() または rdbuf()->sgetc() の呼び出しが Traits::eof() を返す場合）、eofbit を設定します。このストリームの例外マスクで eofbit に対する例外が有効になっている場合（(exceptions() & eofbit) != 0）、ios_base::failure をスローします。
入力中に例外がスローされた場合、入力ストリームに badbit を設定します。このストリームの例外マスクで badbit に対する例外が有効になっている場合（(exceptions() & badbit) != 0）、例外も再スローされます。

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

以下の標準ライブラリ関数は、**UnformattedInputFunction** です。

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

DR	適用対象	公開された動作	正しい動作
LWG 61	C++98	`eofbit` および/または `failbit` の設定によって例外がスローされる場合に、`badbit` が設定されるかどうかは不明確でした。 `eofbit` および/または `failbit` の設定によって例外がスローされる場合に、`badbit` が設定されるかどうか	`basic_ios::clear` からスローされた例外はキャッチまたは再スローされません。
LWG 160	C++98	キャッチされた例外が再スローされるかどうかを決定するプロセスで、存在しない関数 `exception()` に言及していましたが、	`exceptions()` に修正されました。
LWG 243	C++98	`sentry::operator bool()` が false を返す場合、または sentry オブジェクトの構築が失敗した場合の動作は規定されていませんでした。	指定された

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ