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，因此当底层缓冲区耗尽时，它不会尝试获取新缓冲区。

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

定义于头文件 `<spanstream>`
类型	定义
`std::spanbuf`	std::basic_spanbuf<char>
`std::wspanbuf`	std::basic_spanbuf<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`[编辑]

[编辑] 数据成员

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

[编辑] 成员函数

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

[编辑] 非成员函数

std::swap(std::basic_spanbuf)

(C++23)

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

继承自 std::basic_streambuf

成员类型

成员类型	定义
`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_streambuf` 对象 (`std::basic_streambuf<CharT,Traits>` 的虚公有成员函数) [编辑]
区域设置
pubimbue	更改关联的区域设置并调用 imbue() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
getloc	获取关联区域设置的副本 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
定位
pubsetbuf	调用 setbuf() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
pubseekoff	调用 seekoff() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
pubseekpos	调用 seekpos() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
pubsync	调用 sync() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
Get 区域
in_avail	获取 get 区域中立即可用的字符数 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
snextc	推进输入序列，然后读取一个字符而不再次推进 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
sbumpcstossc (C++17 中移除)	从输入序列中读取一个字符并推进序列 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
sgetc	从输入序列中读取一个字符，而不推进序列 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
sgetn	调用 xsgetn() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
Put 区域
sputc	将一个字符写入 put 区域并推进下一个指针 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
sputn	调用 xsputn() (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
放回
sputbackc	将一个字符放回输入序列 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]
sungetc	将输入序列中的下一个指针向后移动一位 (`std::basic_streambuf<CharT,Traits>` 的公有成员函数) [编辑]

保护成员函数

(构造函数)	构造一个 `basic_streambuf` 对象 (保护成员函数) [编辑]
operator= (C++11)	替换一个 `basic_streambuf` 对象 (保护成员函数) [编辑]
swap (C++11)	交换两个 `basic_streambuf` 对象 (保护成员函数) [编辑]
区域设置
imbue [虚函数]	对关联区域设置的更改做出反应 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
定位
setbuf [虚函数]	如果允许，用用户定义的数组替换缓冲区 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
seekoff [虚函数]	使用相对寻址重新定位输入序列、输出序列或两者的下一个指针 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
seekpos [虚函数]	使用绝对寻址重新定位输入序列、输出序列或两者的下一个指针 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
sync [虚函数]	将缓冲区与关联的字符序列同步 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
Get 区域
showmanyc [虚函数]	获取关联输入序列中可用于输入的字符数（如果已知） (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
underflow [虚函数]	从关联的输入序列读取字符到 get 区域 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
uflow [虚函数]	从关联的输入序列读取字符到 get 区域并推进下一个指针 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
xsgetn [虚函数]	从输入序列中读取多个字符 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
ebackgptregptr	返回指向 get 区域的开始、当前字符和结尾的指针 (保护成员函数) [编辑]
gbump	推进输入序列中的下一个指针 (保护成员函数) [编辑]
setg	重新定位输入序列的开始、下一个和结束指针 (保护成员函数) [编辑]
Put 区域
xsputn [虚函数]	将多个字符写入输出序列 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
overflow [虚函数]	将来自 put 区域的字符写入关联的输出序列 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]
pbasepptrepptr	返回指向 put 区域的开始、当前字符和结尾的指针 (保护成员函数) [编辑]
pbump	推进输出序列的下一个指针 (保护成员函数) [编辑]
setp	重新定位输出序列的开始、下一个和结束指针 (保护成员函数) [编辑]
放回
pbackfail [虚函数]	将字符放回输入序列，可能会修改输入序列 (`std::basic_streambuf<CharT,Traits>` 的虚保护成员函数) [编辑]

[编辑] 注解

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

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

特性测试宏	值	Std	特性
`__cpp_lib_spanstream`	`202106L`	(C++23)	`std::spanbuf`, std::spanstream

[编辑] 参见

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

编译器支持
独立和宿主式
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (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_spanbuf::basic_spanbuf (C++23)
basic_spanbuf::operator= (C++23)
basic_spanbuf::swap (C++23)
basic_spanbuf::span (C++23)
保护成员函数
basic_spanbuf::setbuf (C++23)
basic_spanbuf::seekoff (C++23)
basic_spanbuf::seekpos (C++23)
非成员函数
swap(std::basic_spanbuf) (C++23)

cppreference.cn

命名空间

变体

视图

操作

std::basic_spanbuf

内容

[编辑] 成员类型

[编辑] 数据成员

[编辑] 成员函数

公有成员函数

保护成员函数

[编辑] 非成员函数

继承自 std::basic_streambuf

成员类型

成员函数

区域设置

定位

Get 区域

Put 区域

放回

保护成员函数

区域设置

定位

Get 区域

Put 区域

放回

[编辑] 注解

[编辑] 参见

导航

工具箱