std::basic_ios<CharT,Traits>::operator bool

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

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

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

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

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

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

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

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

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ios

メンバ関数

basic_ios::basic_ios

basic_ios::~basic_ios

状態関数

basic_ios::good

basic_ios::eof

basic_ios::fail

basic_ios::bad

basic_ios::operator!

basic_ios::operator bool

basic_ios::rdstate

basic_ios::setstate

basic_ios::clear

書式化

basic_ios::copyfmt

basic_ios::fill

その他

basic_ios::exceptions

basic_ios::imbue

basic_ios::rdbuf

basic_ios::tie

basic_ios::narrow

basic_ios::widen

Protected member functions

basic_ios::init

basic_ios::move (C++11)

basic_ios::swap (C++11)

basic_ios::set_rdbuf (C++11)

 

operator /* 未指定のブール型 */() const;	(1)	(C++11まで)
explicit operator bool() const;	(2)	(C++11以降)

ストリームにエラーがないかチェックします。

1) `fail()` が `true` を返す場合は、ブールコンテキストで `false` に評価される値を返します。それ以外の場合は、ブールコンテキストで `true` に評価される値を返します。

2) ストリームにエラーがなく、I/O 操作の準備ができている場合は `true` を返します。具体的には、`!fail()` を返します。

この演算子により、ストリームやストリームへの参照を返す関数をループ条件として使用できるようになり、`while (stream >> value) {...}` や `while (std::getline(stream, string)) {...}` のような慣用的な C++ の入力ループが可能になります。これらのループは、入力操作が成功した場合にのみループ本体を実行します。

パラメータ

(なし)

戻り値

1) ストリームにエラーがない場合はブールコンテキストで `true` に評価される値、それ以外の場合はブールコンテキストで `false` に評価される値を返します。

2) ストリームにエラーがない場合は `true`、それ以外の場合は `false` を返します。

注意

この変換は、`bool` が期待されるコンテキスト (例: `if` 文の条件) で使用できます。ただし、`bool` で発生する可能性のある暗黙の変換 (例: `int` への変換) は許可されません。

C++98 では、セーフブール問題により `operator bool` を直接提供することはできませんでした。C++98 での最初の解決策は `operator void*` を提供することでしたが、これは `fail()` が `true` を返す場合はヌルポインタを、それ以外の場合はヌルポインタでないポインタを返します。これは、LWG issue 468 の解決により置き換えられ、セーフブールイディオムを適用できるようになりました。

C++11 以降、変換関数は `explicit` にすることができます。LWG issue 1094 の解決により、明示的な `operator bool` が導入され、ブール変換は安全になりました。

例

このコードを実行

#include <iostream>
#include <sstream>
 
int main()
{
    std::istringstream s("1 2 3 error");
    int n;
 
    std::cout << std::boolalpha << "s is " << static_cast<bool>(s) << '\n';
    while (s >> n)
        std::cout << n << '\n';
    std::cout << "s is " << static_cast<bool>(s) << '\n';
}

出力

s is true
1
2
3
s is false

欠陥レポート

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

DR	適用対象	公開された動作	正しい動作
LWG 468	C++98	`operator void*` が提供されていました	代わりに未指定のブール型への変換関数が提供されます

関連項目

以下の表は、すべての可能な ios_base::iostate フラグの組み合わせに対する basic_ios アクセサ（good()、fail() など）の値を示しています。

ios_base::iostate フラグ			basic_ios アクセサ
eofbit	failbit	badbit	good()	fail()	bad()	eof()	operator bool	operator!
false	false	false	true	false	false	false	true	false
false	false	true	false	true	true	false	false	true
false	true	false	false	true	false	false	false	true
false	true	true	false	true	true	false	false	true
true	false	false	false	false	false	true	true	false
true	false	true	false	true	true	true	false	true
true	true	false	false	true	false	true	false	true
true	true	true	false	true	true	true	false	true