std:: basic_osyncstream

From cppreference.net

Definiert im Header `<syncstream>`
template < class CharT, class Traits = std:: char_traits < CharT > , class Allocator = std:: allocator < CharT > > class basic_osyncstream : public std:: basic_ostream < CharT, Traits >		(seit C++20)

Die Klassenvorlage std::basic_osyncstream ist ein praktischer Wrapper für std::basic_syncbuf . Sie bietet einen Mechanismus zur Synchronisierung von Threads, die in denselben Stream schreiben.

Es kann mit einer benannten Variable verwendet werden:

{
    std::osyncstream synced_out(std::cout); // synchronisierter Wrapper für std::cout
    synced_out << "Hello, ";
    synced_out << "World!";
    synced_out << std::endl; // Flush wird notiert, aber noch nicht ausgeführt
    synced_out << "and more!\n";
} // Zeichen werden übertragen und std::cout wird geflusht

sowie mit einem Temporären:

std::osyncstream(std::cout) << "Hallo, " << "Welt!" << '\n';

Es bietet die Garantie, dass alle Ausgaben an denselben endgültigen Zielpuffer ( std::cout in den obigen Beispielen) frei von Datenrennen sein werden und auf keine Weise vermischt oder verstümmelt werden, solange jeder Schreibvorgang in diesen endgültigen Zielpuffer über (möglicherweise verschiedene) Instanzen von std::basic_osyncstream erfolgt.

Typische Implementierung von std::basic_osyncstream enthält nur ein Mitglied: den eingepackten std::basic_syncbuf .

Vererbungsdiagramm

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

Definiert in Header `<syncstream>`
Typ	Definition
`std::osyncstream`	std :: basic_osyncstream < char >
`std::wosyncstream`	std :: basic_osyncstream < wchar_t >

Inhaltsverzeichnis

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`
`streambuf_type`	std:: basic_streambuf < CharT, Traits >
`syncbuf_type`	std:: basic_syncbuf < CharT, Traits, Allocator >

Memberfunktionen

(constructor)	Konstruiert ein `basic_osyncstream` Objekt (öffentliche Elementfunktion)
operator=	weist ein `basic_osyncstream` Objekt zu (öffentliche Elementfunktion)
(destructor)	zerstört den `basic_osyncstream` und gibt seinen internen Puffer frei (öffentliche Elementfunktion)
rdbuf	erhält einen Zeiger auf den zugrundeliegenden `basic_syncbuf` (öffentliche Elementfunktion)
get_wrapped	erhält einen Zeiger auf den finalen Ziel-Stream-Puffer (öffentliche Elementfunktion)
emit	ruft `emit()` auf dem zugrundeliegenden `basic_syncbuf` auf, um seine internen Daten an das finale Ziel zu übertragen (öffentliche Elementfunktion)

Geerbt von std:: basic_ostream

Elementfunktionen

Formatierte Ausgabe
operator<<	fügt formatierte Daten ein (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )
Unformatierte Ausgabe
put	fügt ein Zeichen ein (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )
write	fügt Zeichenblöcke ein (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )
Positionierung
tellp	gibt die Ausgabepositionsanzeige zurück (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )
seekp	setzt die Ausgabepositionsanzeige (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )
Verschiedenes
flush	synchronisiert mit dem zugrundeliegenden Speichergerät (öffentliche Elementfunktion von `std::basic_ostream<CharT,Traits>` )

Elementklassen

sentry

implementiert grundlegende Logik für die Vorbereitung des Streams für Ausgabeoperationen
(öffentliche Elementklasse von


            std::basic_ostream<CharT,Traits>

)

Geerbt von std:: basic_ios

Member-Typen

Member-Typ	Definition
`char_type`	`CharT`
`traits_type`	`Traits`
`int_type`	`Traits::int_type`
`pos_type`	`Traits::pos_type`
`off_type`	`Traits::off_type`

Member-Funktionen

Status-Funktionen
good	prüft, ob kein Fehler aufgetreten ist, d.h. I/O-Operationen verfügbar sind (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
eof	prüft, ob das Dateiende erreicht wurde (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
fail	prüft, ob ein Fehler aufgetreten ist (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
bad	prüft, ob ein nicht behebbarer Fehler aufgetreten ist (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
operator!	prüft, ob ein Fehler aufgetreten ist (Synonym für fail() ) (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
operator bool	prüft, ob kein Fehler aufgetreten ist (Synonym für `!` fail() ) (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
rdstate	gibt Statusflags zurück (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
setstate	setzt Statusflags (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
clear	modifiziert Statusflags (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
Formatierung
copyfmt	kopiert Formatierungsinformationen (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
fill	verwaltet das Füllzeichen (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
Sonstiges
exceptions	verwaltet die Ausnahmemaske (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
imbue	setzt das Locale (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
rdbuf	verwaltet den assoziierten Streampuffer (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
tie	verwaltet den verknüpften Stream (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
narrow	verengt Zeichen (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )
widen	erweitert Zeichen (öffentliche Member-Funktion von `std::basic_ios<CharT,Traits>` )

Geerbt von std:: ios_base

Memberfunktionen

Formatierung
flags	verwaltet Formatierungsflags (öffentliche Elementfunktion von `std::ios_base` )
setf	setzt spezifische Formatierungsflags (öffentliche Elementfunktion von `std::ios_base` )
unsetf	löscht spezifische Formatierungsflags (öffentliche Elementfunktion von `std::ios_base` )
precision	verwaltet Dezimalgenauigkeit von Gleitkommaoperationen (öffentliche Elementfunktion von `std::ios_base` )
width	verwaltet Feldbreite (öffentliche Elementfunktion von `std::ios_base` )
Locales
imbue	setzt Locale (öffentliche Elementfunktion von `std::ios_base` )
getloc	gibt aktuelle Locale zurück (öffentliche Elementfunktion von `std::ios_base` )
Internes erweiterbares Array
xalloc [static]	gibt eine programmweit eindeutige Ganzzahl zurück, die sicher als Index für `pword()` und `iword()` verwendet werden kann (öffentliche statische Elementfunktion von `std::ios_base` )
iword	vergrößert bei Bedarf den privaten Speicher und ermöglicht Zugriff auf das long -Element am gegebenen Index (öffentliche Elementfunktion von `std::ios_base` )
pword	vergrößert bei Bedarf den privaten Speicher und ermöglicht Zugriff auf das void * -Element am gegebenen Index (öffentliche Elementfunktion von `std::ios_base` )
Verschiedenes
register_callback	registriert Ereignis-Callback-Funktion (öffentliche Elementfunktion von `std::ios_base` )
sync_with_stdio [static]	legt fest, ob C++ und C I/O-Bibliotheken interoperabel sind (öffentliche statische Elementfunktion von `std::ios_base` )
Elementklassen
failure	Stream-Exception (öffentliche Elementklasse von `std::ios_base` )
Init	initialisiert Standard-Stream-Objekte (öffentliche Elementklasse von `std::ios_base` )

Membertypen und Konstanten

Typ Erklärung

openmode

Stream-Öffnungsmodus-Typ

Folgende Konstanten sind ebenfalls definiert:

Konstante	Erklärung
`app`	springt vor jedem Schreibvorgang zum Ende des Streams
`binary`	öffnet im Binärmodus
`in`	zum Lesen öffnen
`out`	zum Schreiben öffnen
`trunc`	verwirft den Inhalt des Streams beim Öffnen
`ate`	springt unmittelbar nach dem Öffnen zum Ende des Streams
`noreplace` (C++23)	im exklusiven Modus öffnen

(Typedef)

fmtflags

Formatierungsflags-Typ

Die folgenden Konstanten sind ebenfalls definiert:

Konstante	Erklärung
`dec`	Dezimalbasis für Integer-Ein-/Ausgabe verwenden: siehe std::dec
`oct`	Oktalbasis für Integer-Ein-/Ausgabe verwenden: siehe std::oct
`hex`	Hexadezimalbasis für Integer-Ein-/Ausgabe verwenden: siehe std::hex
`basefield`	dec \| oct \| hex . Nützlich für Maskierungsoperationen
`left`	Linksbündige Ausrichtung (fügt Füllzeichen rechts hinzu): siehe std::left
`right`	Rechtsbündige Ausrichtung (fügt Füllzeichen links hinzu): siehe std::right
`internal`	Interne Ausrichtung (fügt Füllzeichen an internem Punkt hinzu): siehe std::internal
`adjustfield`	left \| right \| internal . Nützlich für Maskierungsoperationen
`scientific`	Gleitkommatypen in wissenschaftlicher Notation oder Hex-Notation (kombiniert mit fixed ) generieren: siehe std::scientific
`fixed`	Gleitkommatypen in Festkomma-Notation oder Hex-Notation (kombiniert mit scientific ) generieren: siehe std::fixed
`floatfield`	scientific \| fixed . Nützlich für Maskierungsoperationen
`boolalpha`	bool -Typ im alphanumerischen Format einfügen und extrahieren: siehe std::boolalpha
`showbase`	Präfix für numerische Basis bei Integer-Ausgabe generieren, Währungsindikator bei monetärer Ein-/Ausgabe anfordern: siehe std::showbase
`showpoint`	Dezimalpunkt für Gleitkomma-Ausgabe immer generieren: siehe std::showpoint
`showpos`	+ -Zeichen für nicht-negative numerische Ausgabe generieren: siehe std::showpos
`skipws`	Führende Leerzeichen vor bestimmten Eingabeoperationen überspringen: siehe std::skipws
`unitbuf`	Ausgabe nach jeder Ausgabeoperation leeren: siehe std::unitbuf
`uppercase`	Bestimmte Kleinbuchstaben durch Großbuchstaben in bestimmten Ausgabeoperationen ersetzen: siehe std::uppercase

(Typdefinition)

iostate

Zustandstyp des Streams

Folgende Konstanten sind ebenfalls definiert:

Konstante	Erklärung
`goodbit`	kein Fehler
`badbit`	nicht behebbarer Stream-Fehler
`failbit`	Ein-/Ausgabeoperation fehlgeschlagen (Formatierungs- oder Extraktionsfehler)
`eofbit`	zugehörige Eingabesequenz hat Dateiende erreicht

(Typdefinition)

seekdir

Suchrichtungstyp

Folgende Konstanten sind ebenfalls definiert:

Konstante	Erklärung
`beg`	der Anfang eines Streams
`end`	das Ende eines Streams
`cur`	die aktuelle Position des Stream-Positionsindikators

(Typdefinition)

event

gibt den Ereignistyp an
(enum)

event_callback

Callback-Funktionstyp
(typedef)

Hinweise

Feature-Test Makro	Wert	Std	Funktion
`__cpp_lib_syncbuf`	`201803L`	(C++20)	Synchronisierter gepufferter ostream ( `std::osyncstream` , std::syncbuf ) und Manipulatoren

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

I/O manipulators
Print functions (C++23)
C-style I/O
Buffers
basic_streambuf
basic_filebuf
basic_stringbuf
basic_spanbuf (C++23)
strstreambuf ( C++98/26* )
basic_syncbuf (C++20)
Streams
Abstractions
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
File 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* )
Synchronized Output
basic_osyncstream (C++20)
Types
streamoff
streamsize
fpos
Error category interface
iostream_category (C++11)
io_errc (C++11)

Public member functions
basic_osyncstream::basic_osyncstream (C++20)
basic_osyncstream::operator= (C++20)
basic_osyncstream::~basic_osyncstream (C++20)
basic_osyncstream::rdbuf (C++20)
basic_osyncstream::get_wrapped (C++20)
basic_osyncstream::emit (C++20)

cppreference.net

Namespaces

Variants

std:: basic_osyncstream

Inhaltsverzeichnis

Mitgliedertypen

Memberfunktionen

Geerbt von std:: basic_ostream

Elementfunktionen

Formatierte Ausgabe

Unformatierte Ausgabe

Positionierung

Verschiedenes

Elementklassen

Geerbt von std:: basic_ios

Member-Typen

Member-Funktionen

Status-Funktionen

Formatierung

Sonstiges

Geerbt von std:: ios_base

Memberfunktionen

Formatierung

Locales

Internes erweiterbares Array

Verschiedenes

Elementklassen

Membertypen und Konstanten

Hinweise