std::basic_ios<CharT,Traits>:: fail

関連するストリームでエラーが発生した場合に true を返します。具体的には、 rdstate() 内の badbit または failbit が設定されている場合に true を返します。

ios_base::iostate が設定する条件の一覧については、 failbit または badbit を参照してください。

パラメータ

(なし)

戻り値

true エラーが発生した場合、 false それ以外の場合。

例

#include <cstdlib>
#include <fstream>
#include <iostream>
int main()
{
    std::ifstream file("test.txt");
    if (!file) // operator! is used here
    {  
        std::cout << "ファイルオープンに失敗しました\n";
        return EXIT_FAILURE;
    }
    // typical C++ I/O loop uses the return value of the I/O function
    // as the loop controlling condition, operator bool() is used here
    for (int n; file >> n;)
       std::cout << n << ' ';
    std::cout << '\n';
    if (file.bad())
        std::cout << "読み込み中にI/Oエラーが発生しました\n";
    else if (file.eof())
        std::cout << "ファイル終端に正常に到達しました\n";
    else if (file.fail())
        std::cout << "整数以外のデータが見つかりました\n";
}

関連項目

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