C++ benannte Anforderungen: FormattedOutputFunction

 

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 FormattedOutputFunction ist eine Stream-Ausgabefunktion, die Folgendes ausführt:

• Konstruiert ein Objekt des Typs basic_ostream::sentry mit automatischer Speicherzuweisung, welches Folgendes ausführt:

• Wenn eofbit oder badbit im Ausgabestrom gesetzt sind, wird auch failbit gesetzt, und wenn Ausnahmen für failbit in der Ausnahmemaske dieses Ausgabestroms aktiviert sind ((exceptions() & failbit) != 0), wird ios_base::failure ausgelöst.
• Leert den gekoppelten Ausgabestrom, falls zutreffend.

• Prüft den Status des Sentry durch Aufrufen von sentry::operator bool(), was äquivalent zu basic_ios::good ist.
• Wenn der Sentry false zurückgibt oder der Konstruktor des Sentry eine Ausnahme auslöst, erfolgt keine Ausgabe.
• Wenn der Sentry true zurückgibt, wird versucht, die gewünschte Ausgabe durch Einfügen der Zeichen in den Ausgabestrom auszufü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() außer overflow(), xsputn() und sync() werden niemals aufgerufen.

• Wenn die Ausgabe nicht generiert werden konnte, wird failbit gesetzt. Wenn Ausnahmen für failbit in der Ausnahmemaske dieses Stroms aktiviert sind ((exceptions() & failbit) != 0), wird ios_base::failure ausgelöst.
• Wenn während der Ausgabe eine Ausnahme ausgelöst wird, wird badbit im Ausgabestrom gesetzt. Wenn Ausnahmen für badbit in der Ausnahmemaske dieses Stroms aktiviert sind ((exceptions() & badbit) != 0), wird die Ausnahme ebenfalls erneut ausgelöst.
• Wenn keine Ausnahme ausgelöst wurde, wird *this zurückgegeben.

• In jedem Fall, ob durch Ausnahme beendet oder Rückgabe, wird der Destruktor des Sentry aufgerufen, bevor diese Funktion verlassen wird.

Auffüllen

Formatierte Ausgabefunktionen bestimmen das Auffüllen gemäß std::num_put::do_put() Stufe 3.

(bis C++14)

Wenn eine formatierte Ausgabefunktion eines Stroms os das Auffüllen bestimmt, tut sie dies wie folgt. Gegeben sei eine CharT-Zeichensequenz seq, wobei CharT der Zeichencontainertyp von os ist. Wenn die Länge von seq kleiner ist als os.width(), werden dieser Sequenz so viele Kopien von os.fill() hinzugefügt, wie benötigt, um auf eine Breite von os.width() Zeichen aufzufüllen. Wenn (os.flags() & std::ios_base::adjustfield) == std::ios_base::left true ist, werden die Füllzeichen nach der Zeichensequenz platziert; andernfalls werden sie vor der Zeichensequenz platziert.

(seit C++14)

Standardbibliothek

Die folgenden Standardbibliotheksfunktionen sind FormattedOutputFunctions.

• basic_ostream::operator<<(std::basic_ostream&, int / long / double / void* / bool)
• operator<<(std::basic_ostream&, char)
• operator<<(std::basic_ostream&, char*)
• operator<<(std::basic_ostream&, const std::bitset&)
• operator<<(std::basic_ostream&, const std::basic_string&)
• operator<< , wenn aufgerufen auf den Rückgabewert von std::put_money

operator<<(std::basic_ostream&, std::basic_string_view)

(seit C++17)

print(std::ostream&, std::format_string<Args...>, Args&&...), println(std::ostream&, std::format_string<Args...>, Args&&...), vprint_unicode(std::ostream&, std::string_view, std::format_args), vprint_nonunicode(std::ostream&, std::string_view, std::format_args), außer dass (gegeben os ist ein Ausgabe-Stream-Objekt) jede Ausnahme, die durch den Aufruf von std::vformat ausgelöst wird, wird ohne Rücksicht auf den Wert von os.exceptions() weitergegeben und ohne ios_base::badbit im Fehlerzustand von os zu setzen; Wenn das Einfügen in os fehlschlägt, wird os.setstate(ios_base::badbit) aufgerufen (was ios_base::failure auslösen kann).

(seit C++23)

Fehlerberichte

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 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	das einzige virtuelle Mitglied, das aufgerufen werden durfte auf rdbuf() war overflow()	auch erlaubt xsputn() und sync()