std:: basic_spanstream
|
定义于头文件
<spanstream>
|
||
|
template
<
class
CharT,
|
(C++23 起) | |
类模板
std::basic_spanstream
实现了基于固定缓冲区的流输入输出操作。
在底层，该类本质上将 std::basic_spanbuf 的原始设备实现封装到 std::basic_iostream 的高级接口中。同时提供了对 std::basic_spanbuf 独有成员的完整接口支持。
继承关系图
提供了多种常见字符类型的类型定义：
|
定义于头文件
<spanstream>
|
|
| 类型 | 定义 |
std::spanstream
|
std :: basic_spanstream < char > |
std::wspanstream
|
std :: basic_spanstream < 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
|
数据成员
| 成员名称 | 定义 |
sb
(private)
|
被包装的
std::basic_spanbuf
。
( 仅用于说明的成员对象* ) |
成员函数
构造
basic_spanstream
(公开成员函数) |
|
|
(析构函数)
[虚函数]
|
销毁
basic_spanstream
(虚公开成员函数) |
移动赋值
basic_spanstream
(公开成员函数) |
|
交换两个
basic_spanstream
对象
(公开成员函数) |
|
获取包装的原始
span
设备对象的地址
(公开成员函数) |
|
底层缓冲区操作 |
|
获取或设置包装的
span
设备对象的底层缓冲区
(公开成员函数) |
|
非成员函数
|
特化
std::swap
算法
(函数模板) |
继承自 std:: basic_istream
成员函数
格式化输入 |
|
|
提取格式化数据
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
非格式化输入 |
|
|
提取字符
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
读取下一个字符但不提取它
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
取消提取字符
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
将字符放回输入流
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
提取字符直到找到指定字符
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
提取并丢弃字符直到找到指定字符
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
提取字符块
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
提取已可用的字符块
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
返回上次非格式化输入操作提取的字符数
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
定位 |
|
|
返回输入位置指示器
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
|
设置输入位置指示器
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
杂项 |
|
|
与底层存储设备同步
(
std::basic_istream<CharT,Traits>
的公开成员函数)
|
|
成员类
|
实现为流输入操作准备的基本逻辑
(
std::basic_istream<CharT,Traits>
的公开成员类)
|
继承自 std:: basic_ostream
成员函数
格式化输出 |
|
|
插入格式化数据
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
无格式输出 |
|
|
插入单个字符
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
|
插入字符块
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
定位操作 |
|
|
返回输出位置指示器
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
|
设置输出位置指示器
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
杂项操作 |
|
|
与底层存储设备同步
(
std::basic_ostream<CharT,Traits>
的公开成员函数)
|
|
成员类
|
实现为流输出操作做准备的基础逻辑
(
std::basic_ostream<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
|
成员函数
状态函数 |
|
|
检查是否未发生错误（即 I/O 操作可用）
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否已到达文件末尾
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否已发生错误
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否已发生不可恢复的错误
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否已发生错误（
fail()
的同义词）
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
检查是否未发生错误（
!
fail()
的同义词）
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
返回状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
设置状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
修改状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
格式化 |
|
|
复制格式化信息
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理填充字符
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
杂项 |
|
|
管理异常掩码
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
设置本地化环境
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理关联的流缓冲区
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理绑定的流
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
窄化字符
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
宽化字符
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
继承自 std:: ios_base
成员函数
格式化 |
|
|
管理格式标志
(
std::ios_base
的公开成员函数)
|
|
|
设置特定格式标志
(
std::ios_base
的公开成员函数)
|
|
|
清除特定格式标志
(
std::ios_base
的公开成员函数)
|
|
|
管理浮点运算的十进制精度
(
std::ios_base
的公开成员函数)
|
|
|
管理字段宽度
(
std::ios_base
的公开成员函数)
|
|
本地化 |
|
|
设置本地化环境
(
std::ios_base
的公开成员函数)
|
|
|
返回当前本地化环境
(
std::ios_base
的公开成员函数)
|
|
内部可扩展数组 |
|
|
[static]
|
返回程序范围内唯一的整数，可安全用作
pword()
和
iword()
的索引
(
std::ios_base
的公开静态成员函数)
|
|
必要时调整私有存储大小并访问指定索引处的
long
元素
(
std::ios_base
的公开成员函数)
|
|
|
必要时调整私有存储大小并访问指定索引处的
void
*
元素
(
std::ios_base
的公开成员函数)
|
|
杂项 |
|
|
注册事件回调函数
(
std::ios_base
的公开成员函数)
|
|
|
[static]
|
设置 C++ 与 C I/O 库是否可互操作
(
std::ios_base
的公开静态成员函数)
|
成员类 |
|
|
流异常
(
std::ios_base
的公开成员类)
|
|
|
初始化标准流对象
(
std::ios_base
的公开成员类)
|
|
成员类型与常量 |
|||||||||||||||
| 类型 | 说明 | ||||||||||||||
|
流打开模式类型
同时定义以下常量：
|
|||||||||||||||
注释
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_spanstream
|
202106L
|
(C++23) |
std::spanbuf
,
std::spanstream
|