std::basic_ifstream

定义在头文件 `<fstream>` 中
template< class CharT, class Traits = std::char_traits<CharT> > class basic_ifstream : public std::basic_istream<CharT, Traits>

类模板 basic_ifstream 在基于文件的流上实现高级输入操作。它将基于文件的流缓冲区 (std::basic_filebuf) 与 (std::basic_istream) 的高级接口连接起来。

std::basic_ifstream 的典型实现只包含一个非派生数据成员：一个 std::basic_filebuf<CharT, Traits> 实例。

继承图

提供了几种用于常见字符类型的 typedef

定义在头文件 `<fstream>` 中
类型	定义
`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`[编辑]
`native_handle_type`(C++26)	实现定义的类型，该类型是 TriviallyCopyable 并且 `semiregular`[编辑]

[编辑] 成员函数

(构造函数)	构造文件流 (公共成员函数) [编辑]
(析构函数) [virtual] (隐式声明)	析构 `basic_ifstream` 及其关联缓冲区，关闭文件 (虚拟公共成员函数) [编辑]
operator= (C++11)	移动文件流 (公共成员函数) [编辑]
swap (C++11)	交换两个文件流 (公共成员函数) [编辑]
rdbuf	返回底层的原始文件设备对象 (公共成员函数) [编辑]
native_handle (C++26)	返回底层的实现定义的句柄 (公共成员函数) [编辑]
文件操作
is_open	检查流是否与文件相关联 (公共成员函数) [编辑]
open	打开文件并将其与流关联 (公共成员函数) [编辑]
close	关闭关联文件 (公共成员函数) [编辑]

[编辑] 非成员函数

std::swap(std::basic_ifstream)

(C++11)

专门化 std::swap 算法
(函数模板) [编辑]

从 std::basic_istream 继承而来

成员函数

格式化输入
operator>>	提取格式化数据 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
非格式化输入
get	提取字符 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
peek	读取下一个字符，但不提取它 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
unget	将一个字符放回输入流 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
putback	将一个字符放回输入流 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
getline	提取字符直到找到给定字符 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
ignore	提取并丢弃字符，直到找到给定字符 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
read	提取字符块 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
readsome	提取已有的字符块 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
gcount	返回上次非格式化输入操作提取的字符数量 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
定位
tellg	返回输入位置指示器 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
seekg	设置输入位置指示器 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]
其他
sync	与底层存储设备同步 (`std::basic_istream<CharT,Traits>` 的公共成员函数) [编辑]

成员类

sentry

实现用于准备输入操作的流的基本逻辑
(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`

成员函数

状态函数
good	检查是否未发生错误，即 I/O 操作可用 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
eof	检查是否已到达文件末尾 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
fail	检查是否已发生错误 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
bad	检查是否已发生不可恢复的错误 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
operator!	检查是否已发生错误（fail() 的同义词） (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
operator bool	检查是否未发生错误（`!`fail() 的同义词） (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
rdstate	返回状态标志 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
setstate	设置状态标志 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
clear	修改状态标志 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
格式化
copyfmt	复制格式化信息 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
fill	管理填充字符 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
其他
exceptions	管理异常掩码 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
imbue	设置区域设置 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
rdbuf	管理关联的流缓冲区 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
tie	管理绑定的流 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
narrow	缩小字符 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]
widen	扩展字符 (`std::basic_ios<CharT,Traits>` 的公共成员函数) [编辑]

继承自 std::ios_base

成员函数

格式化
flags	管理格式标志 (`std::ios_base` 的公共成员函数) [编辑]
setf	设置特定的格式标志 (`std::ios_base` 的公共成员函数) [编辑]
unsetf	清除特定的格式标志 (`std::ios_base` 的公共成员函数) [编辑]
precision	管理浮点运算的小数精度 (`std::ios_base` 的公共成员函数) [编辑]
width	管理字段宽度 (`std::ios_base` 的公共成员函数) [编辑]
区域设置
imbue	设置区域设置 (`std::ios_base` 的公共成员函数) [编辑]
getloc	返回当前区域设置 (`std::ios_base` 的公共成员函数) [编辑]
内部可扩展数组
xalloc [静态]	返回一个程序范围的唯一整数，可以安全地用作 `pword()` 和 `iword()` 的索引 (`std::ios_base` 的公共静态成员函数) [编辑]
iword	如果需要，调整私有存储的大小，并访问给定索引处的 long 元素 (`std::ios_base` 的公共成员函数) [编辑]
iword	如果需要，调整私有存储的大小，并访问给定索引处的 void* 元素 (`std::ios_base` 的公共成员函数) [编辑]
其他
register_callback	注册事件回调函数 (`std::ios_base` 的公共成员函数) [编辑]
sync_with_stdio [静态]	设置 C++ 和 C I/O 库是否可互操作 (`std::ios_base` 的公共静态成员函数) [编辑]
成员类
failure	流异常 (`std::ios_base` 的公共成员类) [编辑]
Init	初始化标准流对象 (`std::ios_base` 的公共成员类) [编辑]

成员类型和常量

类型说明

openmode

流打开模式类型

还定义了以下常量

常量	说明[编辑]
`app`	每次写入之前都定位到流的末尾[编辑]
`binary`	以二进制模式打开[编辑]
`in`	以读模式打开[编辑]
`out`	以写模式打开[编辑]
`trunc`	打开时丢弃流的内容[编辑]
`ate`	在打开后立即定位到流的末尾[编辑]
`noreplace` (C++23)	以独占模式打开[编辑]

(typedef) [编辑]

fmtflags

格式化标志类型

还定义了以下常量

常量	说明[编辑]
`dec`	对整数 I/O 使用十进制基数：参见 std::dec[编辑]
`oct`	对整数 I/O 使用八进制基数：参见 std::oct[编辑]
`hex`	对整数 I/O 使用十六进制基数：参见 std::hex[编辑]
`basefield`	dec \| oct \| hex. 适用于掩码操作[编辑]
`left`	左对齐（在右侧添加填充字符）：参见 std::left[编辑]
`right`	右对齐（在左侧添加填充字符）：参见 std::right[编辑]
`internal`	内部对齐（在内部指定点添加填充字符）：参见 std::internal[编辑]
`adjustfield`	left \| right \| internal. 适用于掩码操作[编辑]
`scientific`	使用科学记数法生成浮点数类型，或者如果与 fixed 结合使用则使用十六进制记数法：参见 std::scientific[编辑]
`fixed`	使用定点记数法生成浮点数类型，或者如果与 scientific 结合使用则使用十六进制记数法：参见 std::fixed[编辑]
`floatfield`	scientific \| fixed. 适用于掩码操作[编辑]
`boolalpha`	以字母数字格式插入和提取 bool 类型：参见 std::boolalpha[编辑]
`showbase`	生成一个前缀来指示整数输出的数字基数，在货币 I/O 中要求货币指示符：参见 std::showbase[编辑]
`showpoint`	对浮点数输出无条件地生成小数点字符：参见 std::showpoint[编辑]
`showpos`	为非负数输出生成 + 字符：参见 std::showpos[编辑]
`skipws`	在某些输入操作之前跳过前导空格：参见 std::skipws[编辑]
`unitbuf`	在每次输出操作后刷新输出：参见 std::unitbuf[编辑]
`uppercase`	将某些小写字母替换为它们的大写在某些输出操作中的等价物：参见 std::uppercase[编辑]

(typedef) [编辑]

iostate

流状态类型

还定义了以下常量

常量	说明[编辑]
`goodbit`	没有错误[编辑]
`badbit`	不可恢复的流错误[编辑]
`failbit`	输入/输出操作失败（格式化或提取错误）[编辑]
`eofbit`	关联的输入序列已到达文件末尾[编辑]

(typedef) [编辑]

seekdir

寻址方向类型

还定义了以下常量

常量	说明[编辑]
`beg`	流的开头[编辑]
`end`	流的末尾[编辑]
`cur`	流定位指示器的当前位置[编辑]

(typedef) [编辑]

event

指定事件类型
(枚举) [编辑]

event_callback

回调函数类型
(typedef) [编辑]

[编辑] 备注

功能测试宏	值	Std	特性
`__cpp_lib_fstream_native_handle`	202306L	(C++26)	原生句柄支持

[编辑] 示例

运行此代码

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
    std::string filename = "Test.b";
 
    // prepare a file to read
    double d = 3.14;
    std::ofstream(filename, std::ios::binary)
        .write(reinterpret_cast<char*>(&d), sizeof d) << 123 << "abc";
 
    // open file for reading
    std::ifstream istrm(filename, std::ios::binary);
    if (!istrm.is_open())
        std::cout << "failed to open " << filename << '\n';
    else
    {
        double d;
        istrm.read(reinterpret_cast<char*>(&d), sizeof d); // binary input
        int n;
        std::string s;
        if (istrm >> n >> s)                               // text input
            std::cout << "read back from file: " << d << ' ' << n << ' ' << s << '\n';
    }
}

输出

read back from file: 3.14 123 abc

编译器支持
独立和宿主
语言
标准库
标准库头文件
命名要求
功能测试宏 (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)

成员函数
basic_ifstream::basic_ifstream
basic_ifstream::operator= (C++11)
basic_ifstream::swap (C++11)
basic_ifstream::rdbuf
basic_ifstream::native_handle (C++26)
文件操作
basic_ifstream::is_open
basic_ifstream::open
basic_ifstream::close
非成员函数
swap(std::basic_ifstream) (C++11)

cppreference.com

命名空间

变体

视图

操作

std::basic_ifstream

内容

[编辑] 成员类型

[编辑] 成员函数

文件操作

[编辑] 非成员函数

从 std::basic_istream 继承而来

成员函数

格式化输入

非格式化输入

定位

其他

成员类

继承自 std::basic_ios

成员类型

成员函数

状态函数

格式化

其他

继承自 std::ios_base

成员函数

格式化

区域设置

内部可扩展数组

其他

成员类

成员类型和常量

[编辑] 备注

[编辑] 示例

导航

工具箱