std::strstream::str

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

std::strstream

成員函式

strstream::strstream

strstream::~strstream

strstream::rdbuf

strstream::str

strstream::pcount

strstream::freeze

 

char* str();		(C++98 起棄用) (C++26 中移除)

返回指向緩衝區起始的指標，並在返回前凍結緩衝區。實際上呼叫 rdbuf()->str()。

引數

(無)

返回值

指向關聯的 std::strstreambuf 中緩衝區起始的指標，如果無可用緩衝區則返回空指標。

注意

在使用 str() 的結果作為 C 字串之前，流緩衝區必須以空字元結尾。常規輸出（例如 stream << 1.2）不會儲存空終止符，必須顯式附加，通常使用操縱器 std::ends。

呼叫 str() 後，動態流會被凍結。在退出建立此 strstream 物件的範圍之前，需要呼叫 freeze(false)，否則解構函式將導致記憶體洩漏。此外，對凍結流的額外輸出一旦達到分配緩衝區的末尾，可能會被截斷，這可能導致緩衝區沒有以空字元結尾。

示例

執行此程式碼

#include <iostream>
#include <strstream>
 
int main()
{
    std::strstream dyn; // dynamically-allocated output buffer
    dyn << "Test: " << 1.23; // not adding std::ends to demonstrate append behavior
    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 "

另請參閱

str	將緩衝區標記為凍結並返回輸入序列的起始指標 (std::strstreambuf 的公共成員函式)