C++ Benannte Anforderungen: UnformattedInputFunction

 

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

1) Erstellt ein Objekt vom Typ basic_istream::sentry mit automatischer Speicherverwaltung und dem Argument noskipws auf true 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.
• Leert den verbundenen Ausgabestream (tie()'d), falls zutreffend.

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

• Wenn der Operator false zurückgibt oder der Konstruktor des Sentry-Objekts eine Ausnahme auslöst.

• Setzt die Anzahl der extrahierten Zeichen (gcount) im Eingabestream auf Null.
• Wenn die Funktion zum Schreiben in ein Array von CharT aufgerufen wurde, wird CharT() (das Nullzeichen) an die erste Position des Arrays geschrieben.

• Wenn der Operator true zurückgibt, wird die Eingabe so durchgeführt, als ob rdbuf()->sbumpc() oder rdbuf()->sgetc() aufgerufen würde.

• Wenn das Ende des Streams erreicht ist (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.

• Ausnahmen, die von basic_ios::clear ausgelöst werden, werden nicht abgefangen oder erneut ausgelöst.

• Wenn während der Eingabe keine Ausnahme ausgelöst wurde, wird die Anzahl der extrahierten Zeichen (gcount) im Eingabestream gesetzt.

3) In jedem Fall, ob durch Ausnahme beendet oder durch Rückgabe, wird der Destruktor des Sentry-Objekts aufgerufen, bevor die Funktion verlassen wird.

Standardbibliothek

Die folgenden Standardbibliotheksfunktionen sind UnformattedInputFunctions.

• std::getline, mit der Ausnahme, dass es gcount nicht modifiziert.
• basic_istream::operator>>(basic_streambuf*)
• basic_istream::get
• basic_istream::getline
• basic_istream::ignore
• basic_istream::peek
• basic_istream::read
• basic_istream::readsome
• basic_istream::putback, mit der Ausnahme, dass es zuerst eofbit löscht.
• basic_istream::unget, mit der Ausnahme, dass es zuerst eofbit löscht.
• basic_istream::sync, mit der Ausnahme, dass es gcount nicht modifiziert.
• basic_istream::tellg, mit der Ausnahme, dass es gcount nicht modifiziert.
• basic_istream::seekg, mit der Ausnahme, dass es zuerst eofbit löscht und gcount nicht modifiziert.
• std::ws, mit der Ausnahme, dass es gcount nicht modifiziert.

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 61	C++98	war unklar, ob das Auslösen einer Ausnahme aufgrund des Setzens von eofbit und/oder failbit zum Setzen von badbit führen würde	Ausnahmen, die von basic_ios::clear ausgelöst werden nicht abgefangen oder erneut ausgelöst werden
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 243	C++98	das Verhalten, wenn sentry::operator bool() false zurückgibt oder das Sentry-Objekt nicht konstruiert werden konnte, war nicht spezifiziert	spezifiziert