std:: basic_spanbuf

定义于头文件 <spanstream>
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_spanbuf : public std:: basic_streambuf < CharT, Traits >		(C++23 起)

std::basic_spanbuf 是一种 std::basic_streambuf ，其关联的字符序列是内存驻留的任意字符序列，该序列可从 std:: span < CharT > 实例初始化或作为其形式提供。

std::basic_spanbuf 在固定缓冲区上执行I/O操作，因此当底层缓冲区耗尽时不会尝试获取新缓冲区。

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

定义于头文件 <spanstream>
类型	定义
std::spanbuf	std :: basic_spanbuf < char >
std::wspanbuf	std :: basic_spanbuf < wchar_t >

目录 1 成员类型 2 数据成员 3 成员函数 3.1 公共成员函数 3.2 受保护成员函数 4 非成员函数 5 继承自 std:: basic_streambuf 5.1 成员类型 5.2 成员函数 5.2.1 本地化 5.2.2 定位操作 5.2.3 获取区域 5.2.4 放置区域 5.2.5 回退操作 5.3 受保护成员函数 5.3.1 本地化 5.3.2 定位操作 5.3.3 获取区域 5.3.4 放置区域 5.3.5 回退操作 5.4 备注 5.5 参见

成员类型

成员类型	定义
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

数据成员

成员名称	定义
mod (private)	记录打开模式的 std::ios_base::openmode 。 ( 仅用于说明的成员对象* )
buf (private)	引用底层缓冲区的 std:: span < CharT > 。 ( 仅用于说明的成员对象* )

成员函数

公开成员函数
(构造函数)	构造 basic_spanbuf 对象 (公开成员函数)
(析构函数) [virtual]	销毁 basic_spanbuf 对象 (虚公开成员函数)
operator=	赋值 basic_spanbuf 对象 (公开成员函数)
swap	交换两个 basic_spanbuf 对象 (公开成员函数)
span	根据模式获取或初始化底层缓冲区 (公开成员函数)
受保护成员函数
setbuf [virtual]	尝试用数组替换受控字符序列 (虚受保护成员函数)
seekoff [virtual]	使用相对寻址重定位输入序列、输出序列或两者中的下一个指针 (虚受保护成员函数)
seekpos [virtual]	使用绝对寻址重定位输入序列、输出序列或两者中的下一个指针 (虚受保护成员函数)

非成员函数

std::swap (std::basic_spanbuf) (C++23)

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

注释

std::basic_spanbuf 不拥有底层缓冲区。

程序员有责任确保底层缓冲区在被 std::basic_spanbuf 对象使用时处于其生命周期内。若多个线程通过不同的 std::basic_spanbuf 对象操作同一底层缓冲区，则可能需要额外的同步机制。

功能测试 宏	值	标准	功能
__cpp_lib_spanstream	202106L	(C++23)	std::spanbuf , std::spanstream

参见

basic_stringbuf	实现原始字符串设备 (类模板)
strstreambuf (C++98 中已弃用) (C++26 中已移除)	实现原始字符数组设备 (类)