C++ benannte Anforderungen: FormattedInputFunction

 

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 FormattedInputFunction ist eine Stream-Eingabefunktion, die Folgendes durchführt:

• Erstellt ein Objekt vom Typ basic_istream::sentry mit automatischer Speicherlebensdauer und dem Argument noskipws auf false gesetzt, was Folgendes bewirkt:

• Wenn eofbit oder badbit im Eingabestream gesetzt sind, wird auch failbit gesetzt. Wenn Ausnahmen für failbit in der Ausnahmemaske dieses Eingabestreams aktiviert sind ((exceptions() & failbit) != 0), wird ios_base::failure ausgelöst.
• Spült den verbundenen Ausgabestream, falls zutreffend.
• Wenn das Flag ios_base::skipws in diesem Eingabestream gesetzt ist, werden Zeichen aus dem Eingabestream extrahiert und verworfen, bis eine der folgenden Bedingungen zutrifft:

• Das nächste verfügbare Zeichen im Eingabestream ist kein Whitespace-Zeichen, wie es die std::ctype-Facet der aktuell in diesem Eingabestream eingebetteten Locale testet. Das Nicht-Whitespace-Zeichen wird nicht extrahiert.
• Das Ende des Streams wird erreicht, in diesem Fall werden failbit und eofbit gesetzt. Wenn Ausnahmen für eines dieser Bits aktiviert sind, wird ios_base::failure ausgelöst.

• Überprüft den Status des sentry durch Aufruf von sentry::operator bool(), was äquivalent zu basic_ios::good ist.
• Wenn der sentry false zurückgibt oder der Konstruktor von sentry eine Ausnahme auslöst, findet keine Eingabe statt.
• Wenn der sentry true zurückgibt, erfolgt die Eingabe so, als ob rdbuf()->sbumpc() oder rdbuf()->sgetc() aufgerufen würde.

• Wenn das Ende des Streams erreicht wird (der Aufruf von rdbuf()->sbumpc() oder rdbuf()->sgetc() gibt Traits::eof() zurück), wird eofbit gesetzt. Wenn Ausnahmen für eofbit in der Ausnahmemaske dieses Streams aktiviert sind ((exceptions() & eofbit) != 0), wird ios_base::failure ausgelöst.
• Wenn während der Eingabe eine Ausnahme ausgelöst wird, wird badbit im Eingabestream gesetzt. Wenn Ausnahmen für 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 *this zurückgegeben.

• In jedem Fall, ob durch Ausnahme beendet oder durch Rückgabe, wird der Destruktor des sentry vor dem Verlassen dieser Funktion aufgerufen.

Standardbibliothek

Die folgenden Standardbibliotheksfunktionen sind FormattedInputFunctions.

• basic_istream::operator>>(int, long, double, void*, bool)
• operator>>(std::basic_istream, char&)
• operator>>(std::basic_istream, char*)
• operator>>(std::basic_istream, std::bitset)
• operator>>(std::basic_istream, std::string)
• operator>>, wenn aufgerufen auf den Rückgabewert von std::get_money

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()