ostrstream-Klasse

  • Artikel

Beschreibt ein Objekt, das das Einfügen von Elementen und programmierten Objekten in einen Streampuffer der Klasse strstreambuf steuert.

Syntax

class ostrstream : public ostream

Hinweise

Das Objekt speichert ein Objekt der Klasse strstreambuf.

Hinweis

Diese Klasse ist veraltet. Verwenden Sie stattdessen ostringstream oder wostringstream.

Konstruktoren

Konstruktor Beschreibung
ostrstream Konstruiert ein Objekt vom Typ ostrstream.

Memberfunktionen

Memberfunktion Beschreibung
freeze Bewirkt, dass ein Streampuffer durch Streampuffervorgänge nicht verfügbar ist.
pcount Gibt die Anzahl der Elemente zurück, die in die kontrollierte Sequenz geschrieben wurde.
rdbuf Gibt einen Zeiger auf das dem Stream zugeordnete strstreambuf-Objekt zurück.
str Ruft freeze auf gibt dann einen Zeiger am Anfang der kontrollierten Sequenz zurück.

Anforderungen

Header:<strstream>

Namespace: std

ostrstream::freeze

Bewirkt, dass ein Streampuffer durch Streampuffervorgänge nicht verfügbar ist.

void freeze(bool _Freezeit = true);

Parameter

_Freezeit
Ein bool, der angibt, ob der Stream fixiert werden soll.

Hinweise

Die Memberfunktion ruft rdbuf ->freeze(_ Freezeit) auf.

Beispiel

Ein Beispiel, das verwendet freezewird, finden Sie unter strstream::freeze.

ostrstream::ostrstream

Konstruiert ein Objekt vom Typ ostrstream.

ostrstream();

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

Parameter

ptr
Der Puffer.

count
Die Größe des Puffers in Byte.

_Modus
Der Eingabe- und Ausgabemodus des Puffers. Weitere Informationen finden Sie unter ios_base::openmode.

Hinweise

Beide Konstruktoren initialisieren die Basisklasse durch Aufrufen von ostream(sb), wobei sb das gespeicherte Objekt der Klasse strstreambuf ist. Der erste Konstruktor initialisiert sb auch durch Aufrufen strstreambufvon . Der zweite Konstruktor initialisiert die Basisklasse auf einer von zwei Arten:

  • Wenn _Mode & ios_base::app== 0, muss das ptr erste Element eines Arrays von count Elementen festgelegt werden, und der Konstruktor ruft strstreambuf(ptr, count, ptr).

  • Andernfalls muss das erste Element eines Arrays von Count-Elementen festgelegt werden, ptr das eine C-Zeichenfolge enthält, deren erstes Element durch ptr, und der Konstruktor aufruft strstreambuf(ptr, count,strlenptr + ( ptr) ).

ostrstream::p count

Gibt die Anzahl der Elemente zurück, die in die kontrollierte Sequenz geschrieben wurde.

streamsize pcount() const;

Rückgabewert

Die Anzahl der Elemente, die in die kontrollierte Sequenz geschrieben wurden.

Hinweise

Die Memberfunktion gibt rdbuf ->pcount zurück.

Beispiel

Siehe strstream::pcount für ein Beispiel, das pcount verwendet.

ostrstream::rdbuf

Gibt einen Zeiger auf das dem Stream zugeordnete strstreambuf-Objekt zurück.

strstreambuf *rdbuf() const

Rückgabewert

Ein Zeiger auf das dem Stream zugeordnete strstreambuf-Objekt.

Hinweise

Die Memberfunktion gibt die Adresse des gespeicherten Datenstrompuffers vom Typ pointer"strstreambuf" zurück.

Beispiel

Unter strstreambuf::pcount finden Sie ein Beispiel, das rdbuf verwendet.

ostrstream::str

Ruft freeze auf gibt dann einen Zeiger am Anfang der kontrollierten Sequenz zurück.

char *str();

Rückgabewert

Zeiger auf den Anfang der kontrollierten Sequenz.

Hinweise

Die Memberfunktion gibt rdbuf ->str zurück.

Beispiel

Ein Beispiel, das verwendet strwird, finden Sie unter strstream::str.

Siehe auch

ostream
Threadsicherheit in der C++-Standardbibliothek
iostream-Programmierung
iostreams-Konventionen