文法:

    bool stream::fail();

fail()関数は現在のストリームにエラーが発生していればtrueを、そうでなければfalseを返します。これは、その前の操作が失敗したかどうかを調べるのに使用することができます。

fail()がtrueになる条件としては次のようなものがあります:

• ファイルが見つからない(読み込み用に開く時)。
• ファイルが作成できない(書き込み用に開く時)。
• リクエストされたデータを読み込む前にファイルの終端に到達した。
• データのフォーマットが不正(例えば、数値が期待されてる時など)。

一度failがセットされると、clear()関数を使ってエラー状態を解消するまでは、ストリームに関するすべての操作が失敗します。

関連トピック: bad, clear, eof, exceptions, good, rdstate

ストリームの状態:

• if (s): 前の操作が成功(!s.fail()の短縮形)
• if (s.fail()): 前の操作が失敗
• if (s.eof()): ファイルの末尾まで読み込んだ
• if (s.bad()): 未定義のストリームの状態; ストリームはこれ以上使用できません。
• if (s.good()): bad/eof/failのどれも設定されていない。