std::ostrstream::str

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

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::ostrstream

メンバ関数

ostrstream::ostrstream

ostrstream::~ostrstream

ostrstream::rdbuf

ostrstream::str

ostrstream::freeze

ostrstream::pcount

 

char* str();		(C++98で非推奨) (C++26で削除)

バッファをフリーズした後、バッファの先頭へのポインタを返します。実際には rdbuf()->str() を呼び出します。

パラメータ

(なし)

戻り値

関連付けられた std::strstreambuf のバッファの先頭へのポインタ。バッファが利用できない場合はヌルポインタ。

注釈

str() を C 文字列として結果を使用する呼び出しの前に、ストリームバッファはヌル終端されている必要があります。通常、stream << 1.2 のような通常の出力はヌル終端文字を格納しないため、明示的に追加する必要があります。通常はマニピュレータ std::ends を使用します。

str() の呼び出し後、動的ストリームはフリーズされます。この ostrstream オブジェクトが作成されたスコープを抜ける前に freeze(false) を呼び出す必要があります。そうしないと、デストラクタがメモリリークを起こします。また、フリーズされたストリームへの追加の出力は、割り当てられたバッファの終わりに達すると切り捨てられる可能性があり、バッファがヌル終端されないままになる可能性があります。

例

このコードを実行

#include <iostream>
#include <strstream>
 
int main()
{
    std::ostrstream 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 の public メンバー関数)