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

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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! is used here
    {  
        std::cout << "File opening failed\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 error while reading\n";
    else if (file.eof())
        std::cout << "End of file reached successfully\n";
    else if (file.fail())
        std::cout << "Non-integer data encountered\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	检查文件末尾 (function)