std:: strstreambuf
|
定义于头文件
<strstream>
|
||
|
class
strstreambuf
:
public
std::
basic_streambuf
<
char
>
|
(C++98 中弃用)
(C++26 中移除) |
|
std::strstreambuf
是一种
std::basic_streambuf
，其关联的字符序列是一个字符数组。该数组可以是常量（例如字符串字面值）、可修改但非动态（例如栈分配数组），或动态分配。对于动态数组的情况，
std::strstreambuf
可以在需要时重新分配数组以适应输出（例如通过调用
delete
[
]
和
new
[
]
或用户提供的函数）。
典型的
std::strstreambuf
实现包含四个私有数据成员：
目录 |
注释
在对具有动态缓冲区的流调用
str()
后，必须调用
freeze(false)
以允许
strstreambuf
析构函数在必要时释放缓冲区。
strstreambuf
自 C++98 起已被弃用，并自 C++26 起被移除
。推荐的替代方案是
std::spanbuf
（自 C++23 起）
。
成员函数
公有成员函数 |
|
构造
strstreambuf
对象
(公有成员函数) |
|
|
[virtual]
|
析构
strstreambuf
对象，可选择释放字符数组
(虚函数公有成员函数) |
|
设置/清除缓冲区的冻结状态
(公有成员函数) |
|
|
标记缓冲区为冻结状态并返回输入序列的起始指针
(公有成员函数) |
|
|
返回输出序列中下一指针与起始指针的差值：已写入的字符数
(公有成员函数) |
|
受保护成员函数 |
|
|
[virtual]
|
从输入序列读取字符但不移动下一指针
(虚函数受保护成员函数) |
|
[virtual]
|
回退输入序列以取消获取字符
(虚函数受保护成员函数) |
|
[virtual]
|
向输出序列追加字符，若为动态缓冲区且未冻结可能重新分配或初始分配缓冲区
(虚函数受保护成员函数) |
|
[virtual]
|
尝试用数组替换受控字符序列
(虚函数受保护成员函数) |
|
[virtual]
|
使用相对寻址重新定位输入序列、输出序列或两者中的下一指针
(虚函数受保护成员函数) |
|
[virtual]
|
使用绝对寻址重新定位输入序列、输出序列或两者中的下一指针
(虚函数受保护成员函数) |
继承自 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>
的虚公开成员函数)
|
本地化设置 |
|
|
更改关联的区域设置并调用
imbue
(
)
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
获取关联区域设置的副本
(
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>
的公开成员函数)
|
|
获取区域 |
|
|
获取获取区域中立即可用的字符数量
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
前进输入序列，然后读取一个字符但不再次前进
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
(C++17 中移除)
|
从输入序列读取一个字符并前进序列
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
从输入序列读取一个字符但不前进序列
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
调用
xsgetn
(
)
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
放置区域 |
|
|
向放置区域写入一个字符并前进下一个指针
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
调用
xsputn
(
)
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
回退操作 |
|
|
将一个字符放回输入序列
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
|
将输入序列中的下一个指针向后移动一位
(
std::basic_streambuf<CharT,Traits>
的公开成员函数)
|
|
受保护成员函数
构造
basic_streambuf
对象
(受保护的成员函数) |
|
|
(C++11)
|
替换
basic_streambuf
对象
(受保护的成员函数) |
|
(C++11)
|
交换两个
basic_streambuf
对象
（受保护成员函数） |
区域设置 |
|
|
[virtual]
|
响应关联区域设置的更改
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
定位 |
|
|
[virtual]
|
若允许则用用户自定义数组替换缓冲区
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
使用相对寻址重新定位输入序列、输出序列或两者中的下一个指针
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
使用绝对寻址重新定位输入序列、输出序列或两者中的下一个指针
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
同步缓冲区与关联的字符序列
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
获取面积 |
|
|
[virtual]
|
获取关联输入序列中可供输入的字符数量（若已知）
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
[virtual]
|
从关联的输入序列读取字符到获取区域
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
从关联输入序列读取字符到获取区并推进下一个指针
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
从输入序列读取多个字符
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
|
返回指向获取区域起始位置、当前字符和末尾的指针
（受保护的成员函数） |
|
|
推进输入序列中的下一个指针
(受保护成员函数) |
|
|
重新定位输入序列的起始指针、下一个指针和结束指针
（受保护成员函数） |
|
放置区域 |
|
|
[virtual]
|
向输出序列写入多个字符
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
[virtual]
|
将字符从放置区写入到关联的输出序列
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
返回指向输出区域起始位置、当前字符和末尾的指针
（受保护的成员函数） |
|
|
推进输出序列的下一指针位置
（受保护的成员函数） |
|
|
重新定位输出序列的起始指针、下一个指针和结束指针
(受保护成员函数) |
|
Putback |
|
|
[virtual]
|
将字符放回输入序列，可能修改输入序列
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|