# std::ferror

< cpp‎ | io‎ | c

定义于头文件 `<cstdio>` |  |
int ferror( std::FILE* stream ); |  |

检查给定的流的错误。

### 参数

stream | - | 要检查的文件流

### 返回值

若文件流已出现错误则为非零值，否则为 ​0​ 。

### 示例

    #include <cstdio>
    #include <cstdlib>
    #include <clocale>
    #include <cwchar>

    int main(void)
    {
        const char *fname = std::tmpnam(nullptr);
        std::FILE* f = std::fopen(fname, "wb");
        std::fputs("\xff\xff\n", f); // 不是合法的 UTF-8 字符序列
        std::fclose(f);

        std::setlocale(LC_ALL, "en_US.utf8");
        f = std::fopen(fname, "rb");
        std::wint_t ch;
        while ((ch=std::fgetwc(f)) != WEOF) // 试图作为 UTF-8 读取
              std::printf("%#x ", ch);

        if (std::feof(f))
            puts("EOF indicator set");
        if (std::ferror(f))
            puts("Error indicator set");
    }

输出：

    Error indicator set

### 参阅

clearerr | 清除错误 (函数)
feof | 检查文件尾 (函数)
fail | 检查是否发生了可恢复的错误 (`std::basic_ios<CharT,Traits>` 的公开成员函数)