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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

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

受保护成员函数

basic_ios::init

basic_ios::move (C++11)

basic_ios::swap (C++11)

basic_ios::set_rdbuf (C++11)

 

bool eof() const;

若关联流已抵达文件尾则返回 true。明确说即若 rdstate() 中设置了 eofbit 则返回 true。

设置 eofbit 的条件列表见 ios_base::iostate。

参数

（无）

返回值

若遇到文件尾条件则为 true，否则为 false。

注解

此函数只报告最近的 I/O 操作所设置的流状态；它不检测关联的数据源。例如，若最近的 I/O 为返回文件最后字节的 get()，则 eof() 返回 false。下个 get() 无法读取任何内容，并设置 eofbit。之后 eof() 才返回 true。

典型使用中，输入流处理在任何错误上停止。然后能用 eof() 和 fail() 区别不同的错误条件。

示例

运行此代码

#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";
}

参阅

下表显示 basic_ios 访问器（good()、fail() 等）对于 ios_base::iostate 标志的所有可能组合的值：

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

feof	检查文件尾 (函数)