std::basic_syncbuf<CharT,Traits,Allocator>::emit

 

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)

 

bool emit();

Sendet alle ausstehenden Ausgaben atomar an den umgebenden Stream.

Alle emit()-Aufrufe, die Zeichen an denselben umgebenden Stream-Buffer übertragen, scheinen in einer totalen Reihenfolge ausgeführt zu werden, wobei jeder emit()-Aufruf synchronisiert mit nachfolgenden emit()-Aufrufen in dieser totalen Reihenfolge, selbst wenn diese Aufrufe über unterschiedliche Instanzen von std::basic_syncbuf/std::basic_osyncstream erfolgen. Praktisch bedeutet dies, dass emit() eine Sperre erwirbt, die eindeutig mit dem umgebenden Stream-Objekt verknüpft ist: Sie könnte beispielsweise in einer statischen Hash-Map gehalten werden, bei der die Adresse des umgebenden Streams als Schlüssel verwendet wird.

Wenn seit dem letzten Aufruf von emit() ein Aufruf von sync erfolgt war, wird auch der umgebende Stream geleert, indem pubsync() darauf aufgerufen wird.

Parameter

(keine)

Rückgabewert

true, wenn alle folgenden Bedingungen erfüllt sind

• ein umgebender Stream vorhanden ist (der Zeiger auf den umgebenden Stream-Buffer ist nicht Null)
• alle Zeichen aus dem temporären Speicher erfolgreich in den umgebenden Stream gesendet wurden
• der Aufruf von pubsync(), falls angefordert, ebenfalls erfolgreich abgeschlossen wurde.

Gibt andernfalls false zurück.

Hinweise

Normalerweise aufgerufen vom Destruktor oder der Move-Zuweisung des besitzenden std::basic_osyncstream oder von std::basic_osyncstream::emit.

Siehe auch

(Destruktor)	zerstört das basic_osyncstream-Objekt und gibt seinen internen Puffer aus (public member function of std::basic_osyncstream<CharT,Traits,Allocator>)
emit	ruft emit() auf dem zugrundeliegenden basic_syncbuf auf, um seine internen Daten an das endgültige Ziel zu übertragen (public member function of std::basic_osyncstream<CharT,Traits,Allocator>)
(Konstruktor)	konstruiert ein basic_syncbuf-Objekt (öffentliche Member-Funktion)