C++ benannte Anforderungen: UnformattedOutputFunction

 

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

 

C++ benannte Anforderungen

Basis DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible Typeneigenschaften ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType Bibliothekweit BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

Container Container ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   Container-Element DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) Iterator LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) Stream-I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction Formatters BasicFormatter (C++20) Formatter (C++20)

Zufallszahlen SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) Concurrency BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) Bereiche (Ranges) RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) Mehrdimensionale Ansicht LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) Sonstiges CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

Anforderungen

Eine UnformattedOutputFunction ist eine Stream-Ausgabe-Funktion, die Folgendes ausführt:

1) Konstruiert ein Objekt vom Typ basic_ostream::sentry mit automatischer Speicherverwaltung, das Folgendes ausführt:

• Wenn eofbit oder badbit für den Ausgabestream gesetzt sind, wird auch failbit gesetzt, und wenn Ausnahmen bei `failbit` in der Ausnahmemaske dieses Ausgabestreams aktiviert sind ((exceptions() & failbit) != 0), wird ios_base::failure ausgelöst.
• Spült den gebundenen (`tie()`) Ausgabestream, falls zutreffend.

2) Prüft den Status des Sentry-Objekts durch Aufruf von `sentry::operator bool()`, was äquivalent zu basic_ios::good ist.

• Wenn der Operator false zurückgibt oder der Konstruktor von Sentry eine Ausnahme auslöst, erfolgt keine Ausgabe.
• Wenn der Operator true zurückgibt, wird versucht, die gewünschte Ausgabe durch Einfügen der Zeichen in den Ausgabestream durchzuführen, als ob `rdbuf()->sputc()` aufgerufen würde. Andere öffentliche Member von std::basic_ostream können ebenfalls verwendet werden, aber virtuelle Member von rdbuf() mit Ausnahme von overflow(), xsputn() und sync() werden niemals aufgerufen.

• Wenn während der Ausgabe eine Ausnahme ausgelöst wird, wird `badbit` im Ausgabestream gesetzt. Wenn Ausnahmen bei `badbit` in der Ausnahmemaske dieses Streams aktiviert sind ((exceptions() & badbit) != 0), wird die Ausnahme ebenfalls erneut ausgelöst.
• Wenn keine Ausnahme ausgelöst wurde, wird der von der Funktion angegebene Wert zurückgegeben.

3) In jedem Fall, ob durch Ausnahme beendet oder durch Rückgabe, wird der Destruktor des Sentry-Objekts vor dem Verlassen dieser Funktion aufgerufen.

Standardbibliothek

Die folgenden Standardbibliotheksfunktionen sind UnformattedOutputFunctions.

• basic_ostream::operator<<(basic_streambuf*)
• basic_ostream::put
• basic_ostream::write
• basic_ostream::flush

basic_ostream::tellp (ruft statt Ausgabe pubseekoff auf) basic_ostream::seekp (ruft statt Ausgabe pubseekoff oder pubseekpos auf)

(seit C++11)

Defect Reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 63	C++98	die Ausnahmebehandlungsrichtlinie fehlte	hinzugefügt
LWG 160	C++98	Der Prozess zur Bestimmung, ob die abgefangene Ausnahme erneut ausgelöst wird, erwähnte eine nicht existierende Funktion exception().	korrigiert zu exceptions()
LWG 165	C++98	der einzige virtuelle Member, der aufgerufen werden durfte, auf rdbuf() war `overflow()`	auch erlaubt `xsputn()` und `sync()`