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>
的公开成员函数)</
|
|