std::strstreambuf

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-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*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

std::strstreambuf

Öffentliche Memberfunktionen

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

Geschützte Memberfunktionen

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

Definiert in Header <strstream>
class strstreambuf : public std::basic_streambuf<char>		(veraltet in C++98) (entfernt in C++26)

std::strstreambuf ist ein std::basic_streambuf, dessen zugehörige Zeichensequenz ein Zeichenarray ist, welches konstant sein kann (z.B. ein String-Literal), veränderbar, aber nicht dynamisch (z.B. ein auf dem Stack allokiertes Array) oder dynamisch, in welchem Fall dem std::strstreambuf erlaubt sein kann, das Array bei Bedarf neu zu allokieren, um Ausgaben unterzubringen (z.B. durch Aufruf von delete[] und new[] oder benutzergestellten Funktionen).

Eine typische Implementierung eines std::strstreambuf enthält vier private Datenmember

1) Pufferzustand, ein Bitmaskentyp, der jede Kombination der vier Werte "allokiert" (Destruktor wird deallokieren), "konstant" (Ausgabe nicht erlaubt), "dynamisch" (Ausgabe kann neu allokiert werden) oder "eingefroren" (Deallokation und Neualokation sind nicht erlaubt) darstellen kann.

2) Größe des allokierten Puffers (der Anfang des Puffers benötigt kein spezielles Datenmember, er kann im geerbten Zeiger eback() gespeichert werden).

3) Zeiger auf eine vom Benutzer bereitgestellte Allokationsfunktion.

4) Zeiger auf eine vom Benutzer bereitgestellte Deallokationsfunktion.

Anmerkungen

Nach jedem Aufruf von str() bei einem Stream mit dynamischem Puffer ist ein Aufruf von freeze(false) erforderlich, um dem strstreambuf-Destruktor zu erlauben, den Puffer bei Bedarf zu deallokieren.

strstreambuf wurde seit C++98 als veraltet markiert und seit C++26 entfernt. Der empfohlene Ersatz ist std::spanbuf(seit C++23).

Memberfunktionen

Öffentliche Memberfunktionen
(Konstruktor)	konstruiert ein strstreambuf-Objekt (public member function)
(Destruktor) [virtuell]	destruiert ein strstreambuf-Objekt und deallokiert optional das Zeichenarray (virtual public member function)
freeze	setzt/löscht den "frozen"-Zustand des Puffers (public member function)
str	markiert den Puffer als eingefroren und gibt den Anfangszeiger der Eingabesequenz zurück (public member function)
pcount	gibt den Zeiger auf das nächste Zeichen abzüglich des Anfangszeigers der Ausgabesequenz zurück: die Anzahl der geschriebenen Zeichen (public member function)
Geschützte Memberfunktionen
underflow [virtuell]	liest ein Zeichen aus der Eingabesequenz, ohne den Zeiger auf das nächste Zeichen vorzuschieben (virtual protected member function)
pbackfail [virtuell]	macht die Eingabesequenz rückgängig, um ein Zeichen zurückzulegen (virtual protected member function)
overflow [virtuell]	hängt ein Zeichen an die Ausgabesequenz an, kann den Puffer neu allokieren oder initial allokieren, falls er dynamisch und nicht eingefroren ist (virtual protected member function)
setbuf [virtuell]	versucht, die gesteuerte Zeichensequenz durch ein Array zu ersetzen (virtual protected member function)
seekoff [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung (virtual protected member function)
seekpos [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung absoluter Adressierung (virtual protected member function)

Geerbt von std::basic_streambuf

Membertypen

Mitgliedertyp	Definition
char_type	CharT
traits_type	Traits; das Programm ist fehlerhaft, wenn Traits::char_type nicht CharT ist.
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Memberfunktionen

(Destruktor) [virtuell]	zerstört das basic_streambuf-Objekt (virtuelle öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Lokale
pubimbue	ändert die zugeordnete Locale und ruft imbue() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
getloc	holt eine Kopie der zugeordneten Locale (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Positionierung
pubsetbuf	ruft setbuf() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubseekoff	ruft seekoff() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubseekpos	ruft seekpos() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubsync	ruft sync() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Get-Bereich
in_avail	holt die Anzahl der im Get-Bereich sofort verfügbaren Zeichen (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
snextc	bewegt die Eingabesequenz vorwärts und liest dann ein Zeichen, ohne erneut vorzurücken (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sbumpcstossc (in C++17 entfernt)	liest ein Zeichen aus der Eingabesequenz und rückt die Sequenz vor (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sgetc	liest ein Zeichen aus der Eingabesequenz, ohne die Sequenz vorzurücken (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sgetn	ruft xsgetn() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Put-Bereich
sputc	schreibt ein Zeichen in den Put-Bereich und rückt den nächsten Zeiger vor (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sputn	ruft xsputn() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Putback
sputbackc	legt ein Zeichen zurück in die Eingabesequenz (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sungetc	verschiebt den nächsten Zeiger in der Eingabesequenz um eins zurück (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)

Geschützte Memberfunktionen

(Konstruktor)	konstruiert ein basic_streambuf-Objekt (geschützte Member-Funktion)
operator= (C++11)	ersetzt ein basic_streambuf-Objekt (geschützte Member-Funktion)
swap (C++11)	tauscht zwei basic_streambuf-Objekte (geschützte Member-Funktion)
Lokale
imbue [virtuell]	reagiert auf eine Änderung der zugeordneten Locale (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
Positionierung
setbuf [virtuell]	ersetzt den Puffer durch ein benutzerdefiniertes Array, falls zulässig (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekoff [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekpos [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung absoluter Adressierung (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
sync [virtuell]	synchronisiert die Puffer mit der zugeordneten Zeichensequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
Get-Bereich
showmanyc [virtuell]	holt die Anzahl der für die Eingabe in der zugeordneten Eingabesequenz verfügbaren Zeichen, falls bekannt (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
underflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
uflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich und rückt den nächsten Zeiger vor (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
xsgetn [virtuell]	liest mehrere Zeichen aus der Eingabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
ebackgptregptr	gibt einen Zeiger auf den Anfang, das aktuelle Zeichen und das Ende des Get-Bereichs zurück (geschützte Member-Funktion)
gbump	rückt den nächsten Zeiger in der Eingabesequenz vor (geschützte Member-Funktion)
setg	positioniert die Zeiger für Anfang, nächsten und Ende der Eingabesequenz neu (geschützte Member-Funktion)
Put-Bereich
xsputn [virtuell]	schreibt mehrere Zeichen in die Ausgabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
overflow [virtuell]	schreibt Zeichen aus dem Put-Bereich in die zugeordnete Ausgabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
pbasepptrepptr	gibt einen Zeiger auf den Anfang, das aktuelle Zeichen und das Ende des Put-Bereichs zurück (geschützte Member-Funktion)
pbump	rückt den nächsten Zeiger der Ausgabesequenz vor (geschützte Member-Funktion)
setp	positioniert die Zeiger für Anfang, nächsten und Ende der Ausgabesequenz neu (geschützte Member-Funktion)
Putback
pbackfail [virtuell]	legt ein Zeichen in die Eingabesequenz zurück, möglicherweise unter Änderung der Eingabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)