std::basic_stringbuf

 

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

Öffentliche Memberfunktionen

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

Geschützte Memberfunktionen

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

Nicht-Member-Funktionen

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

Nur exposition-only Memberfunktionen

basic_stringbuf::init_buf_ptrs

 

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

std::basic_stringbuf ist ein std::basic_streambuf, dessen zugeordnete Zeichensequenz eine speicherresidentielle Sequenz beliebiger Zeichen ist, die von einer Instanz von std::basic_string initialisiert werden oder als solche verfügbar gemacht werden kann.

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

Zusätzlich speichert eine typische Implementierung einen Datenmember vom Typ std::ios_base::openmode, um den E/A-Modus des zugehörigen Streams anzuzeigen (nur Eingabe, nur Ausgabe, Ein-/Ausgabe, Ende, etc.).

Wenn eine Überallokationsstrategie von overflow() verwendet wird, kann ein zusätzlicher High-Watermark-Zeiger gespeichert werden, um das zuletzt initialisierte Zeichen zu verfolgen.

(seit C++11)

Mehrere Typedefs für gängige Zeichentypen werden bereitgestellt

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

Member types

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

Exposition-only Mitglieder

buf	die std::basic_string<CharT, Traits, Allocator>, die als zugrundeliegender Puffer verwendet wird ((exposition-only member object*)
mode	der std::ios_base::openmode des zugeordneten Streams ((exposition-only member object*)
init_buf_ptrs	initialisiert die Eingabe- und Ausgabesequenzen (exposition-only Member-Funktion*)

Public Memberfunktionen

(Konstruktor)	konstruiert ein basic_stringbuf-Objekt (public member function)
operator= (C++11)	weist ein basic_stringbuf-Objekt zu (public member function)
swap (C++11)	tauscht zwei basic_stringbuf-Objekte (public member function)
(Destruktor) [virtual] (implizit deklariert)	destruiert ein basic_stringbuf-Objekt und den von ihm gehaltenen String (virtual public member function)
str	ersetzt oder ruft eine Kopie des zugeordneten Zeichenstrings ab (public member function)
get_allocator (C++20)	ruft einen Allocator ab, der dem internen Sequenzcontainer zugeordnet ist (public member function)
view (C++20)	ruft eine Ansicht der zugrundeliegenden Zeichensequenz ab (public member function)

Protected Memberfunktionen

underflow [virtuell]	gibt das nächste in der Eingabesequenz verfügbare Zeichen zurück (virtual protected member function)
pbackfail [virtuell]	legt ein Zeichen zurück in die Eingabesequenz (virtual protected member function)
overflow [virtuell]	hängt ein Zeichen an die Ausgabesequenz an (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)

Nicht-Memberfunktionen

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

spezialisiert den Algorithmus std::swap (Funktionsvorlage)

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