std::basic_syncbuf

 

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_syncbuf

Öffentliche Memberfunktionen

basic_syncbuf::basic_syncbuf (C++20)

basic_syncbuf::operator= (C++20)

basic_syncbuf::~basic_syncbuf (C++20)

basic_syncbuf::swap (C++20)

basic_syncbuf::emit (C++20)

basic_syncbuf::get_wrapped (C++20)

basic_syncbuf::get_allocator (C++20)

basic_syncbuf::set_emit_on_sync (C++20)

Geschützte Memberfunktionen

basic_syncbuf::sync (C++20)

Nicht-Member-Funktionen

swap(std::basic_syncbuf) (C++20)

 

Definiert in Header <syncstream>
template<     class CharT,     Klasse Traits = std::char_traits<CharT>,     Klasse Allocator = std::allocator<CharT> > class basic_syncbuf : public std::basic_streambuf<CharT, Traits>		(seit C++20)

std::basic_syncbuf ist ein Wrapper für einen std::basic_streambuf (der bei der Konstruktion als Zeiger übergeben wird). Er sammelt die Ausgabe in seinem eigenen internen Puffer und überträgt dessen gesamten Inhalt beim Zerstören und wenn explizit angefordert, atomar an den gewickelten Puffer, sodass er als zusammenhängende Zeichenfolge erscheint. Er garantiert, dass es keine Datenrennen und keine Vermischung von Zeichen gibt, die an den gewickelten Puffer gesendet werden, solange alle anderen Ausgaben an denselben Puffer über (möglicherweise unterschiedliche) Instanzen von std::basic_syncbuf erfolgen.

Die typische Implementierung von std::basic_syncbuf enthält einen Zeiger auf den gewickelten std::basic_streambuf, ein boolesches Flag, das angibt, ob der Puffer seinen Inhalt beim Synchronisieren (Flush) an den gewickelten Puffer überträgt, ein boolesches Flag, das einen ausstehenden Flush anzeigt, wenn die Richtlinie darin besteht, nicht beim Synchronisieren zu übertragen, einen internen Puffer, der Allocator (wie z. B. std::string) verwendet, und einen Zeiger auf eine Mutex, die zum Synchronisieren der Übertragung zwischen mehreren Threads verwendet wird, die auf denselben gewickelten Stream-Puffer zugreifen (diese Mutexes können sich in einer Hash-Map befinden, wobei Zeiger auf std::basic_streambuf-Objekte als Schlüssel verwendet werden).

Wie andere Streambuf-Klassen wird std::basic_syncbuf normalerweise nicht direkt, sondern nur über den entsprechenden Stream, std::osyncstream, angesprochen.

Mehrere Typedefs für gängige Zeichentypen werden bereitgestellt

Definiert in Header <syncstream>
Typ	Definition
std::syncbuf	std::basic_syncbuf<char>
std::wsyncbuf	std::basic_syncbuf<wchar_t>

Member-Typen

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
streambuf_type	std::basic_streambuf<CharT, Traits>

Member-Funktionen

Öffentliche Memberfunktionen
(Konstruktor)	konstruiert ein basic_syncbuf-Objekt (öffentliche Member-Funktion)
operator=	weist ein basic_syncbuf-Objekt zu (öffentliche Member-Funktion)
swap	tauscht zwei basic_syncbuf-Objekte (öffentliche Member-Funktion)
(Destruktor)	zerstört das basic_syncbuf und gibt seinen internen Puffer aus (öffentliche Member-Funktion)
emit	überträgt den gesamten internen Puffer atomar an den gewickelten Streambuf (öffentliche Member-Funktion)
get_wrapped	ruft den Zeiger auf den gewickelten Streambuf ab (öffentliche Member-Funktion)
get_allocator	ruft den von diesem basic_syncbuf verwendeten Allocator ab (öffentliche Member-Funktion)
set_emit_on_sync	ändert die aktuelle Policy "emit on sync" (Übertragung beim Synchronisieren) (öffentliche Member-Funktion)
Geschützte Memberfunktionen
sync	gibt entweder aus oder zeichnet einen ausstehenden Flush auf, abhängig von der aktuellen Policy "emit on sync" (öffentliche Member-Funktion)

Nicht-Member-Funktionen

std::swap(std::basic_syncbuf) (C++20)

spezialisiert den Algorithmus std::swap (Funktionsschablone)

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

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_syncbuf	201803L	(C++20)	Synchronisierte gepufferte Ostreams (std::syncbuf, std::osyncstream) und Manipulatoren