命名空间
变体
操作

std::strstreambuf

来自 cppreference.cn
< cpp‎ | io
定义于头文件 <strstream>
class strstreambuf : public std::basic_streambuf<char>
(C++98 起弃用)
(C++26 中移除)

std::strstreambuf 是一个 std::basic_streambuf,其关联字符序列是一个字符数组,该数组可以是常量(例如字符串字面量)、可修改但非动态(例如栈分配的数组),或动态的。如果是动态数组,std::strstreambuf 可以在必要时重新分配数组以适应输出(例如通过调用 delete[]new[] 或用户提供的函数)。

std::strstreambuf 的典型实现包含四个私有数据成员

1) 缓冲区状态,一个位掩码类型,可以表示“已分配”(析构函数将释放)、“常量”(不允许输出)、“动态”(输出可能重新分配)或“冻结”(不允许释放和重新分配)这四个值的任意组合
2) 已分配缓冲区大小(缓冲区的起始地址不需要特殊的数据成员,它可以存储在继承的指针 eback() 中)
3) 指向用户提供的分配函数的指针
4) 指向用户提供的释放函数的指针。

目录

[编辑] 注意

在对具有动态缓冲区的流调用 str() 后,需要调用 freeze(false),以允许 strstreambuf 析构函数在必要时释放缓冲区。

strstreambuf 自 C++98 起已被废弃,并自 C++26 起被移除。推荐的替代方案是 std::spanbuf(自 C++23 起)

[编辑] 成员函数

公开成员函数

构造一个 strstreambuf 对象
(public 成员函数) [编辑]
销毁一个 strstreambuf 对象,可选地释放字符数组
(虚 public 成员函数) [编辑]
设置/清除缓冲区的冻结状态
(public 成员函数) [编辑]
将缓冲区标记为冻结并返回输入序列的起始指针
(public 成员函数) [编辑]
返回输出序列中下一个指针减去起始指针的结果:已写入字符的数量
(public 成员函数) [编辑]

受保护的成员函数

从输入序列中读取一个字符,但不推进下一个指针
(虚 protected 成员函数) [编辑]
将输入序列回退以取消获取一个字符
(虚 protected 成员函数) [编辑]
向输出序列追加一个字符,如果缓冲区是动态且未冻结的,则可能重新分配或初始分配缓冲区
(虚 protected 成员函数) [编辑]
[虚]
尝试用数组替换受控字符序列
(虚 protected 成员函数) [编辑]
使用相对寻址重新定位输入序列、输出序列或两者的下一个指针
(虚 protected 成员函数) [编辑]
使用绝对寻址重新定位输入序列、输出序列或两者的下一个指针
(虚 protected 成员函数) [编辑]

继承自 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> 的虚 public 成员函数) [编辑]
区域设置
更改关联的区域设置并调用 imbue()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
获取关联区域设置的副本
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
定位
调用 setbuf()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
调用 seekoff()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
调用 seekpos()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
调用 sync()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
获取区
获取获取区中立即可用的字符数
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
推进输入序列,然后读取一个字符而不再次推进
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
(C++17 中移除)
从输入序列中读取一个字符并推进序列
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
从输入序列中读取一个字符而不推进序列
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
调用 xsgetn()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
放置区
将一个字符写入放置区并推进下一个指针
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
调用 xsputn()
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
回放
将一个字符放回输入序列
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]
将输入序列中的下一个指针后退一个位置
(std::basic_streambuf<CharT,Traits> 的 public 成员函数) [编辑]

受保护的成员函数

构造 basic_streambuf 对象
(protected 成员函数) [编辑]
(C++11)
替换 basic_streambuf 对象
(protected 成员函数) [编辑]
(C++11)
交换两个 basic_streambuf 对象
(protected 成员函数) [编辑]
区域设置
[虚]
响应关联区域设置的更改
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
定位
[虚]
如果允许,用用户定义的数组替换缓冲区
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
使用相对寻址重新定位输入序列、输出序列或两者的下一个指针
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
使用绝对寻址重新定位输入序列、输出序列或两者的下一个指针
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
[虚]
将缓冲区与关联的字符序列同步
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
获取区
如果已知,获取关联输入序列中可用于输入的字符数
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
从关联输入序列中读取字符到获取区
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
[虚]
从关联输入序列中读取字符到获取区并推进下一个指针
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
[虚]
从输入序列中读取多个字符
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
返回获取区起始、当前字符和结尾的指针
(protected 成员函数) [编辑]
推进输入序列中的下一个指针
(protected 成员函数) [编辑]
重新定位输入序列的起始、下一个和结束指针
(protected 成员函数) [编辑]
放置区
[虚]
向输出序列写入多个字符
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
从放置区向关联输出序列写入字符
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]
返回放置区起始、当前字符和结尾的指针
(protected 成员函数) [编辑]
推进输出序列的下一个指针
(protected 成员函数) [编辑]
重新定位输出序列的起始、下一个和结束指针
(protected 成员函数) [编辑]
回放
将一个字符放回输入序列,可能会修改输入序列
(std::basic_streambuf<CharT,Traits> 的虚 protected 成员函数) [编辑]