std:: basic_filebuf

定义于头文件 <fstream>
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_filebuf : public std:: basic_streambuf < CharT, Traits >

std::basic_filebuf 是一个 std::basic_streambuf ，其关联的字符序列是文件。输入序列和输出序列都与同一文件关联，且为两种操作维护着统一的文件位置。使用 std::basic_filebuf 读写序列的限制与 std::FILE 相同。

函数 underflow() 和 overflow() / sync() 负责执行文件与缓冲区获取区及放置区之间的实际I/O操作。当 CharT 不是 char 时，大多数实现会在文件中存储多字节字符，并使用 std::codecvt 平面来执行宽字符/多字节字符转换。

提供了多种常见字符类型的类型定义：

定义于头文件 <fstream>
类型	定义
std::filebuf	std :: basic_filebuf < char >
std::wfilebuf	std :: basic_filebuf < wchar_t >

目录 1 成员类型 2 成员函数 3 公开成员函数 4 受保护成员函数 5 非成员函数 6 继承自 std:: basic_streambuf 6.1 成员类型 6.2 成员函数 6.2.1 本地化 6.2.2 定位 6.2.3 获取区域 6.2.4 放置区域 6.2.5 回退 6.3 受保护成员函数 6.3.1 本地化 6.3.2 定位 6.3.3 获取区域 6.3.4 放置区域 6.3.5 回退 6.4 备注 6.5 参见

成员类型

类型	定义
char_type	CharT
traits_type	Traits ；若 Traits::char_type 不是 CharT 则程序非良构。
int_type	Traits::int_type
pos_type	必须为 std:: fpos < Traits :: state_type > 的 Traits::pos_type
off_type	Traits::off_type
native_handle_type (C++26)	满足 TriviallyCopyable 与 semiregular 的 实现定义 类型

成员函数

公共成员函数
(constructor)	构造 basic_filebuf 对象 (公共成员函数)
operator= (C++11)	赋值 basic_filebuf 对象 (公共成员函数)
swap (C++11)	交换两个 basic_filebuf 对象 (公共成员函数)
native_handle (C++26)	返回底层实现定义的句柄 (公共成员函数)
(destructor) [virtual]	析构 basic_filebuf 对象并在文件打开时关闭文件 (虚公共成员函数)
is_open	检查关联文件是否打开 (公共成员函数)
open	打开文件并将其配置为关联字符序列 (公共成员函数)
close	刷新输出区缓冲区并关闭关联文件 (公共成员函数)
受保护成员函数
showmanyc [virtual]	可选提供可从文件输入的字符数量 (虚受保护成员函数)
underflow [virtual]	从关联文件读取 (虚受保护成员函数)
uflow [virtual]	从关联文件读取并前移获取区的下一个指针 (虚受保护成员函数)
pbackfail [virtual]	回退输入序列以取消获取字符，不影响关联文件 (虚受保护成员函数)
overflow [virtual]	从输出区向关联文件写入字符 (虚受保护成员函数)
setbuf [virtual]	提供用户提供的缓冲区或使此文件流无缓冲 (虚受保护成员函数)
seekoff [virtual]	重定位文件位置，使用相对寻址 (虚受保护成员函数)
seekpos [virtual]	重定位文件位置，使用绝对寻址 (虚受保护成员函数)
sync [virtual]	从输出区向关联文件写入字符 (虚受保护成员函数)
imbue [virtual]	更改关联的区域设置 (虚受保护成员函数)

非成员函数

std::swap (std::basic_filebuf) (C++11)

特化 std::swap 算法 (函数模板)

注释

功能测试 宏	值	标准	功能
__cpp_lib_fstream_native_handle	202306L	(C++26)	原生句柄支持

参见

FILE	能够保存控制C输入输出流所需全部信息的对象类型 (类型定义)