ostrstream クラス

クラス strstreambuf のストリーム バッファーへの、要素とエンコードされたオブジェクトの挿入を制御するオブジェクトを表します。

構文

class ostrstream : public ostream

解説

このオブジェクトは、クラス strstreambuf のオブジェクトを格納します。

Note

このクラスは非推奨とされます。 代わりに、ostringstream または wostringstream を使用することを検討します。

コンストラクター

コンストラクター	説明
ostrstream	ostrstream 型のオブジェクトを構築します。

メンバー関数

メンバー関数	説明
freeze	ストリーム バッファーの操作により、ストリーム バッファーを使用不可にします。
pcount	被制御シーケンスに書き込まれる要素の数を返します。
rdbuf	ストリームの関連付けられた strstreambuf オブジェクトへのポインターを返します。
str	freeze を呼び出し、被制御シーケンスの先頭へのポインターを返します。

要件

ヘッダー:<strstream>

名前空間: std

ostrstream::freeze

ストリーム バッファーの操作により、ストリーム バッファーを使用不可にします。

void freeze(bool _Freezeit = true);

パラメーター

_Freezeit
ストリームを停止させるかどうか示す bool。

解説

メンバー関数は rdbuf ->freeze(_ Freezeit) を呼び出します。

例

freeze の使用例は、strstream::freeze をご覧ください。

ostrstream::ostrstream

ostrstream 型のオブジェクトを構築します。

ostrstream();

ostrstream(char* ptr,
    streamsize count,
    ios_base::openmode _Mode = ios_base::out);

パラメーター

ptr
バッファーです。

count
バッファーのサイズ (バイト単位)。

_Mode
バッファーの入出力モード。 詳細については、ios_base::openmode をご覧ください。

解説

両方のコンストラクターは、ostream(sb) を呼び出すことにより基本クラスを初期化します。ここで、sb はクラス strstreambuf の格納されているオブジェクトです。 最初のコンストラクターはまた、strstreambuf を呼び出して sb を初期化します。 2 番目のコンストラクターは、次のどちらかの方法で基本クラスを初期化します。

• _Mode &ios_base::app== 0 の場合、ptrはcount要素の配列の最初の要素を指定する必要があり、コンストラクターはstrstreambuf (ptr、count、ptr) を呼び出します。

• それ以外の場合、ptr は count 要素の配列の最初の要素を指定する必要があります。この count 要素は C 文字列を含み、最初の要素が ptr によって指定されるものです。そしてコンストラクターは strstreambuf(ptr, count, ptr + strlen( ptr)) を呼び出します。

ostrstream::p count

被制御シーケンスに書き込まれる要素の数を返します。

streamsize pcount() const;

戻り値

被制御シーケンスに書き込まれる要素の数。

解説

このメンバー関数は、rdbuf ->pcount を返します。

例

pcount の使用例は、strstream::pcount をご覧ください。

ostrstream::rdbuf

ストリームの関連付けられた strstreambuf オブジェクトへのポインターを返します。

strstreambuf *rdbuf() const

戻り値

ストリームの関連付けられた strstreambuf オブジェクトへのポインター。

解説

このメンバー関数は、型 pointer の格納されたストリーム バッファーのアドレスを strstreambuf に返します。

例

rdbuf の使用例は、strstreambuf::pcount をご覧ください。

ostrstream::str

freeze を呼び出し、被制御シーケンスの先頭へのポインターを返します。

char *str();

戻り値

被制御シーケンスの先頭へのポインター。

解説

このメンバー関数は、rdbuf ->str を返します。

例

str の使用例は、strstream::str をご覧ください。

関連項目

ostream
C++ 標準ライブラリ内のスレッド セーフ
iostream プログラミング
iostreams の規則