std:: basic_syncbuf

Definiert im Header <syncstream>
template < class CharT, class Traits = std:: char_traits < CharT > , class 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 (bereitgestellt zur Konstruktionszeit als Zeiger). Es sammelt Ausgabe in seinem eigenen internen Puffer und überträgt seinen gesamten Inhalt atomar an den umschlossenen Puffer bei Destruktion und wenn explizit angefordert, sodass sie als zusammenhängende Zeichenfolge erscheinen. Es garantiert, dass es keine Datenrennen und keine Vermischung von Zeichen gibt, die an den umschlossenen Puffer gesendet werden, solange alle anderen Ausgaben an denselben Puffer über, möglicherweise verschiedene, Instanzen von std::basic_syncbuf erfolgen.

Typische Implementierung von std::basic_syncbuf enthält einen Zeiger auf den eingebetteten std::basic_streambuf , ein boolesches Flag, das anzeigt, ob der Puffer seine Inhalte beim Sync (Flush) an den eingebetteten Puffer überträgt, ein boolesches Flag für einen ausstehenden Flush, wenn die Richtlinie kein Emit bei Sync vorsieht, einen internen Puffer, der Allocator verwendet (wie std::string ), und einen Zeiger auf ein Mutex zur Synchronisation des Emit-Vorgangs zwischen mehreren Threads, die auf denselben eingebetteten Stream-Puffer zugreifen (diese Mutexe können sich in einer Hash-Map befinden, wobei Zeiger auf std::basic_streambuf -Objekte als Schlüssel dienen).

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

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

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

Inhaltsverzeichnis 1 Member-Typen 2 Member-Funktionen 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 6.4 Anmerkungen

Mitgliedertypen

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

Memberfunktionen

Öffentliche Elementfunktionen
(constructor)	konstruiert ein basic_syncbuf Objekt (öffentliche Elementfunktion)
operator=	weist ein basic_syncbuf Objekt zu (öffentliche Elementfunktion)
swap	tauscht zwei basic_syncbuf Objekte (öffentliche Elementfunktion)
(destructor)	zerstört den basic_syncbuf und gibt seinen internen Puffer aus (öffentliche Elementfunktion)
emit	überträgt den gesamten internen Puffer atomar an den gekapselten Streambuf (öffentliche Elementfunktion)
get_wrapped	ruft den Zeiger auf den gekapselten Streambuf ab (öffentliche Elementfunktion)
get_allocator	ruft den von diesem basic_syncbuf verwendeten Allokator ab (öffentliche Elementfunktion)
set_emit_on_sync	ändert die aktuelle Emit-on-Sync-Richtlinie (öffentliche Elementfunktion)
Geschützte Elementfunktionen
sync	gibt entweder aus oder zeichnet einen ausstehenden Flush auf, abhängig von der aktuellen Emit-on-Sync-Richtlinie (öffentliche Elementfunktion)

Nicht-Member-Funktionen

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

spezialisiert den std::swap Algorithmus (Funktionsschablone)

Hinweise

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