std:: basic_stringbuf

Definiert im Header <sstream>
template < class CharT, class Traits = std:: char_traits < CharT > , class Allocator = std:: allocator < CharT > > class basic_stringbuf : public std:: basic_streambuf < CharT, Traits >

std::basic_stringbuf ist ein std::basic_streambuf , dessen zugehörige Zeichenfolge eine speicherresidente Folge beliebiger Zeichen ist, die aus einer Instanz von std::basic_string initialisiert oder als solche verfügbar gemacht werden kann.

Typische Implementierungen von std::basic_stringbuf halten ein Objekt vom Typ std::basic_string oder einen äquivalenten anpassbaren Sequenzcontainer direkt als Datenmember und verwenden es sowohl als gesteuerte Zeichensequenz (das Array, auf das die sechs Zeiger von std::basic_streambuf zeigen) als auch als zugeordnete Zeichensequenz (die Quelle von Zeichen für alle Eingabeoperationen und das Ziel für die Ausgabe).

Zusätzlich enthält eine typische Implementierung ein Datenmitglied vom Typ std::ios_base::openmode um den I/O-Modus des zugehörigen Streams anzugeben (nur Eingabe, nur Ausgabe, Eingabe/Ausgabe, am Ende, etc.).

Falls eine Überbelegungsstrategie von overflow() verwendet wird, kann ein zusätzlicher High-Watermark-Zeiger gespeichert werden, um das letztinitialisierte Zeichen zu verfolgen.

(since C++11)

Es werden mehrere Typdefinitionen für gängige Zeichentypen bereitgestellt:

Definiert im Header <sstream>
Typ	Definition
std::stringbuf	std :: basic_stringbuf < char >
std::wstringbuf	std :: basic_stringbuf < wchar_t >

Inhaltsverzeichnis 1 Member-Typen 2 Nur-Darstellungs-Member 3 Öffentliche Member-Funktionen 4 Geschützte Member-Funktionen 5 Nicht-Member-Funktionen 6 Geerbt von std:: basic_streambuf 6.1 Member-Typen 6.2 Member-Funktionen 6.2.1 Locales 6.2.2 Positionierung 6.2.3 Lesebereich 6.2.4 Schreibbereich 6.2.5 Zurücklegen 6.3 Geschützte Member-Funktionen 6.3.1 Locales 6.3.2 Positionierung 6.3.3 Lesebereich 6.3.4 Schreibbereich 6.3.5 Zurücklegen

Mitgliedertypen

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
allocator_type	Allocator

Nur zur Darstellung bestimmte Member

buf	der std:: basic_string < CharT, Traits, Allocator > , der als zugrundeliegender Puffer verwendet wird ( Nur zur Darstellung verwendetes Mitgliedsobjekt* )
mode	der std::ios_base::openmode des zugehörigen Streams ( Nur zur Darstellung verwendetes Mitgliedsobjekt* )
init_buf_ptrs	initialisiert die Eingabe- und Ausgabesequenzen ( Nur zur Darstellung verwendete Mitgliedsfunktion* )

Öffentliche Elementfunktionen

(constructor)	konstruiert ein basic_stringbuf Objekt (öffentliche Elementfunktion)
operator= (C++11)	weist ein basic_stringbuf Objekt zu (öffentliche Elementfunktion)
swap (C++11)	tauscht zwei basic_stringbuf Objekte (öffentliche Elementfunktion)
(destructor) [virtual] (implizit deklariert)	zerstört ein basic_stringbuf Objekt und die enthaltene Zeichenkette (virtuelle öffentliche Elementfunktion)
str	ersetzt oder erhält eine Kopie der assoziierten Zeichenkette (öffentliche Elementfunktion)
get_allocator (C++20)	erhält eine Kopie des mit dem internen Sequenzcontainer assoziierten Allokators (öffentliche Elementfunktion)
view (C++20)	erhält eine Ansicht über die zugrundeliegende Zeichensequenz (öffentliche Elementfunktion)

Geschützte Memberfunktionen

underflow [virtual]	gibt das nächste verfügbare Zeichen in der Eingabesequenz zurück (virtuelle geschützte Memberfunktion)
pbackfail [virtual]	stellt ein Zeichen wieder in die Eingabesequenz zurück (virtuelle geschützte Memberfunktion)
overflow [virtual]	hängt ein Zeichen an die Ausgabesequenz an (virtuelle geschützte Memberfunktion)
setbuf [virtual]	versucht, die gesteuerte Zeichensequenz durch ein Array zu ersetzen (virtuelle geschützte Memberfunktion)
seekoff [virtual]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beiden unter Verwendung relativer Adressierung neu (virtuelle geschützte Memberfunktion)
seekpos [virtual]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beiden unter Verwendung absoluter Adressierung neu (virtuelle geschützte Memberfunktion)

Nicht-Member-Funktionen

std::swap (std::basic_stringbuf) (C++11)

spezialisiert den std::swap Algorithmus (Funktions-Template)