std::ostrstream::str

< cpp‎ | io‎ | ostrstream

char* str();

冻结缓冲区后,返回指向其起始的指针。等效地调用 rdbuf()->str()

参数

(无)

返回值

指向关联 std::strsteambuf 中缓冲区起始的指针,或若无可用缓冲区则为空指针。

注解

若要将结果用作 C 字符串,则调用 str() 前流缓冲区必须为空终止。常规输出,例如 stream << 1.2 不存储空终止符,必须显式后附它,典型地用操纵符 std::ends

调用 str() 后,动态流变为冻结。要求在退出创建此 ostrstream 对象于其中的作用域前调用 freeze(false) 。否则析构函数将泄露内存。还有,一旦到被冻结流的附加输出抵达分配的缓冲区结尾,则它可能被截断,这可能令缓冲区为非空终止。

示例

#include <strstream>
#include <iostream>
 
int main()
{
    std::ostrstream dyn; // 动态分配的输出缓冲区
    dyn << "Test: " << 1.23; // 不添加 std::ends 以演示后附行为
    std::cout << "The output stream holds \"";
    std::cout.write(dyn.str(), dyn.pcount()) << "\"\n"; 
    // the stream is now frozen due to str()
    dyn << " More text" << std::ends;
    std::cout << "The output stream holds \"";
    std::cout.write(dyn.str(), dyn.pcount()) << "\"\n";
    dyn.freeze(false);
}

可能的输出:

The stream holds "Test: 1.23"
The stream holds "Test: 1.23 More "

参阅

标记缓冲为冻结并返回输入序列的起始指针
(std::strstreambuf 的公开成员函数)