std::strstream::str

来自cppreference.com
< cpp‎ | io‎ | strstream
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 的公开成员函数)[编辑]
close