std::strstream::str
来自cppreference.com
char* str(); | (C++98 弃用) (C++26 移除) | |
冻结缓冲区后,返回指向其起始的指针。相当于调用 rdbuf()->str()。
目录 |
[编辑]参数
(无)
[编辑]返回值
指向关联 std::strstreambuf 中缓冲区起始的指针,或若无可用缓冲区则为空指针。
注解
若要将结果用作 C 字符串,则调用 str()
前流缓冲区必须为空终止。常规输出,例如 stream <<1.2 不存储空终止符,必须显式后附它,通常使用操纵符 std::ends。
调用 str()
后,动态流变为冻结。要求在退出创建此 strstream 对象于其中的作用域前调用 freeze(false)
,否则析构函数将泄露内存。还有,一旦到被冻结流的附加输出抵达分配的缓冲区结尾,则它可能被截断,这可能令缓冲区为非空终止。
[编辑]示例
运行此代码
#include <iostream>#include <strstream> int main(){std::strstream dyn;// 动态分配的输出缓冲区 dyn <<"Test: "<<1.23;// 不添加 std::ends 以演示后附行为std::cout<<"输出流持有 \"";std::cout.write(dyn.str(), dyn.pcount())<<"\"\n";// 流现在由于 str() 而冻结 dyn <<" More text"<<std::ends;std::cout<<"输出流持有 \"";std::cout.write(dyn.str(), dyn.pcount())<<"\"\n"; dyn.freeze(false);}
可能的输出:
输出流持有 "Test: 1.23" 输出流持有 "Test: 1.23 More "
参阅
标记缓冲为冻结并返回输入序列的起始指针 ( std::strstreambuf 的公开成员函数) |