C++

参考

<fstream>

basic_filebuf

类模板
<fstream>

std::basic_filebuf

template < class charT, class traits = char_traits<charT> >  class basic_filebuf;
文件流缓冲区

用于从文件读取和写入文件的流缓冲区。

这些对象在构造时没有关联，通过调用成员函数 open 来与文件关联。一旦 open，对象上执行的所有输入/输出操作都将反映在关联的文件中。

此类对象可能在内部维护一个输入中间缓冲区和/或一个输出中间缓冲区，其中个别字符由输入/输出操作读取或写入。这些缓冲区会在填满时、在显式请求时（sync）或在对象 close 时与文件的内容同步。

通过调用成员函数 pubsetbuf 并将两个参数都设置为零（参见成员函数 setbuf）来显式地使此类对象成为无缓冲的：无缓冲的文件流缓冲区直接在文件上执行输入/输出操作，而不使用中间缓冲区。

通过此类重写的、从 basic_streambuf 继承的虚成员提供的接口，可以将对关联字符序列（即文件）的访问提供给流。

模板参数

charT
字符类型。
这应是一个非数组的 POD 类型。
别名为成员类型 basic_filebuf::char_type。
特性 (traits)
字符特性类，它定义了流对象使用的字符的基本属性（参见char_traits）。
traits::char_type 应当与 charT 相同。
别名为成员类型 basic_filebuf::traits_type。

sub_match for string literals (class)

filebuf
文件流缓冲区 (类)
wfilebuf
文件流缓冲区（宽字符）(类)
这些实例化在 <fstream> 中声明。

成员类型

成员类型定义说明
char_type第一个模板参数（charT）
traits_type第二个模板参数（traits）默认为：char_traits<charT>
int_typetraits_type::int_type
pos_typetraits_type::pos_type通常与 streampos 相同
off_typetraits_type::off_type通常与 streamoff 相同

公开成员函数

（构造函数）
构造对象 （公开成员函数）
(析构函数)
析构对象 (公共成员函数)
operator=
移动赋值 (公开成员函数)
swap
交换文件缓冲区 (公开成员函数)

文件关联

open
打开文件 (公开成员函数)
is_open
检查文件是否打开 (公开成员函数)
close
关闭文件 (公开成员函数)

从 basic_streambuf 继承的公有成员函数

区域设置:
pubimbue
注入 locale （公开成员函数）
getloc
获取当前 locale （公开成员函数）
缓冲区管理和定位:
pubsetbuf
设置缓冲区数组 (公有成员函数)
pubseekoff
将内部位置指针设置为相对位置 (公有成员函数)
pubseekpos
将内部位置指针设置为绝对位置 (公有成员函数)
pubsync
同步流缓冲区 (公有成员函数)
输入函数 (get):
in_avail
获取可读的字符数 (公开成员函数)
snextc
前进到下一个位置并获取字符 (公有成员函数)
sbumpc
获取当前字符并前进到下一个位置 (公有成员函数)
sgetc
获取当前字符 (公有成员函数)
sgetn
获取字符序列 (公有成员函数)
sputbackc
放回字符 (公共成员函数)
sungetc
后退当前位置 (公有成员函数)
输出函数 (put):
sputc
放置字符并前进到下一位置 (公开成员函数)
sputn
放置字符序列 (公有成员函数)

受保护的虚函数重写

showmanyc
获取可用字符数 (公开成员函数)
underflow
在下溢时获取字符 (保护虚成员函数)
uflow
在上溢时获取字符并前进位置 (受保护的虚成员函数)
pbackfail
在下溢时放回字符 (受保护的虚成员函数)
overflow
在上溢时放置字符 (保护虚成员函数)
setbuf
设置缓冲区 (保护虚成员函数)
seekoff
将内部位置设置为相对位置 (受保护的虚成员函数)
seekpos
将位置指针设置为绝对位置 (受保护的虚成员函数)
sync
同步缓冲区 (受保护的虚成员函数)
imbue
注入区域设置 (保护虚成员函数)

此类还继承了其他非虚或未被重写的保护成员。更多详情请参见基类 basic_streambuf。

非成员函数重载

swap
交换文件缓冲区 (函数模板)