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!
    {  
        std::cout << "文件打开失败\n";
        return EXIT_FAILURE;
    }
    // 典型的 C++ I/O 循环使用 I/O 函数的返回值作为循环控制条件，此处使用了 operator bool()
    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";
}

参阅

以下表格展示了所有可能的 ios_base::iostate 标志组合下， basic_ios 访问器（ good() 、 fail() 等）的对应值：