std::basic_ifstream - cppreference.com
来自cppreference.com
template< class CharT, class Traits = std::char_traits<CharT> > class basic_ifstream : public std::basic_istream<CharT, Traits> |
||
类模板 basic_ifstream 实现文件流上的高层输入操作。它将 std::basic_istream 的高层接口赋予基于文件的流缓冲（std::basic_filebuf）。
std::basic_ifstream 的典型实现只保有一个非派生数据成员：std::basic_filebuf<CharT, Traits> 的一个实例。
继承图
提供了几个针对常用字符类型的 typedef：
| 类型 | 定义 |
std::ifstream
|
std::basic_ifstream<char>
|
std::wifstream
|
std::basic_ifstream<wchar_t>
|
成员类型
| 成员类型 | 定义 |
char_type
|
CharT[编辑]
|
traits_type
|
Traits；Traits::char_type 不是 CharT 时程序非良构。[编辑]
|
int_type
|
Traits::int_type[编辑]
|
pos_type
|
Traits::pos_type[编辑]
|
off_type
|
Traits::off_type[编辑]
|
成员函数
| 构造文件流 (公开成员函数) [编辑] | |
(析构函数) [虚] (隐式声明) |
析构 basic_ifstream 和关联的缓冲区，并关闭文件 (虚公开成员函数) [编辑] |
(C++11) |
移动文件流 (公开成员函数) [编辑] |
(C++11) |
交换两个文件流 (公开成员函数) [编辑] |
| 返回底层未处理的文件设备对象 (公开成员函数) [编辑] | |
(C++26) |
返回底层的由实现定义的句柄 (公开成员函数) [编辑] |
文件操作 | |
| 检查流是否有关联文件 (公开成员函数) [编辑] | |
| 打开文件，并将它与流关联 (公开成员函数) [编辑] | |
| 关闭关联文件 (公开成员函数) [编辑] | |
非成员函数
继承自 std::basic_istream
成员函数
有格式输入 | |
| 提取带格式数据 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
无格式输入 | |
| 提取字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 读取下一个字符，但不会提取它 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 撤销上一个字符的提取 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 往输入流中放置一个字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 持续提取字符，直到找到给定字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 持续提取并丢弃字符，直到找到给定字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 按区块提取字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 提取已经可用的字符区块 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 返回上次无格式输入操作提取的字符数量 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
寻位 | |
| 返回输入位置指示器 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
| 设置输入位置指示器 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
杂项 | |
| 与底层存储设备同步 ( std::basic_istream<CharT,Traits> 的公开成员函数) [编辑]
| |
成员类
| 实现为输出操作准备流的基本逻辑 ( std::basic_istream<CharT,Traits> 的公开成员类) [编辑]
|
继承自 std::basic_ios
成员类型
| 成员类型 | 定义 |
char_type
|
CharT
|
traits_type
|
Traits
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
成员函数
状态函数 | |
| 检查是否没有发生错误，即是否可执行输入/输出操作 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 检查是否到达了文件末尾 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 检查是否发生了可恢复的错误 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 检查是否已发生不可恢复的错误 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 检查是否有错误发生（fail() 的同义词） ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
检查是否没有发生错误（!std::basic_ios::fail 的同义词） ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 返回状态标志 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 设置状态标志 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 修改状态标志 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
格式化 | |
| 复制格式化信息 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 管理填充字符 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
杂项 | |
| 管理异常掩码 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 设置本地环境 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 管理相关的流缓冲区 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 管理绑定的流 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 窄化字符 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
| 拓宽字符 ( std::basic_ios<CharT,Traits> 的公开成员函数) [编辑]
| |
注解
| 功能特性测试宏 | 值 | 标准 | 功能特性 |
|---|---|---|---|
__cpp_lib_fstream_native_handle |
202306L |
(C++26) | 原生句柄支持 |
示例
#include <fstream> #include <iostream> #include <string> int main() { std::string filename = "Test.b"; // 准备读取文件 double d = 3.14; std::ofstream(filename, std::ios::binary) .write(reinterpret_cast<char*>(&d), sizeof d) << 123 << "abc"; // 打开文件以读取 std::ifstream istrm(filename, std::ios::binary); if (!istrm.is_open()) std::cout << "打开 " << filename << " 失败\n"; else { double d; istrm.read(reinterpret_cast<char*>(&d), sizeof d); // 二进制输入 int n; std::string s; if (istrm >> n >> s) // 文本输入 std::cout << "从文件读回：" << d << ' ' << n << ' ' << s << '\n'; } }
输出：