std::out_of_range

 

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

 

Diagnostik-Bibliothek

Ausnahmebehandlung exception uncaught_exceptionuncaught_exceptions (bis C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (bis C++17*) unexpected_handler (bis C++17*) get_unexpected (bis C++17*) set_unexpected (bis C++17*) Fehlernummern Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging-Unterstützung is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

Definiert in der Header-Datei <stdexcept>
class out_of_range;

Definiert einen Objekttyp, der als Ausnahme geworfen wird. Er meldet Fehler, die Folge des Versuchs sind, auf Elemente zuzugreifen, die sich außerhalb des definierten Bereichs befinden.

Es kann durch die Memberfunktionen von std::bitset und std::basic_string, durch die Funktionen der std::stoi und std::stod-Familien sowie durch die grenzgeprüften Member-Zugriffsfunktionen (z. B. std::vector::at und std::map::at) geworfen werden.

Vererbungdiagramm

Memberfunktionen

(Konstruktor)	konstruiert ein neues out_of_range-Objekt mit der gegebenen Nachricht (öffentliche Memberfunktion)
operator=	weist das out_of_range-Objekt zu (öffentliche Memberfunktion)

std::out_of_range::out_of_range

out_of_range( const std::string& what_arg );	(1)
out_of_range( const char* what_arg );	(2)
out_of_range( const out_of_range& other );	(3)	(noexcept seit C++11)

1) Konstruiert das Ausnahmeobjekt mit what_arg als erklärende Zeichenkette. Nach der Konstruktion gilt std::strcmp(what(), what_arg.c_str()) == 0.

2) Konstruiert das Ausnahmeobjekt mit what_arg als erklärende Zeichenkette. Nach der Konstruktion gilt std::strcmp(what(), what_arg) == 0.

3) Kopierkonstruktor. Wenn *this und other beide den dynamischen Typ std::out_of_range haben, dann ist std::strcmp(what(), other.what()) == 0. Aus dem Kopierkonstruktor kann keine Ausnahme geworfen werden.

Parameter

what_arg	-	erklärende Zeichenkette
Sonstiges	-	ein anderes Ausnahmeobjekt zum Kopieren

Ausnahmen

1,2) Kann std::bad_alloc auslösen.

Anmerkungen

Da das Kopieren von std::out_of_range keine Ausnahmen auslösen darf, wird diese Nachricht typischerweise intern als separat zugeordneter, referenzgezählter String gespeichert. Dies ist auch der Grund, warum es keinen Konstruktor gibt, der std::string&& übernimmt: Der Inhalt müsste ohnehin kopiert werden.

Vor der Auflösung von LWG-Problem 254 konnte der Nicht-Kopierkonstruktor nur std::string akzeptieren. Dies machte die dynamische Speicherzuweisung zur obligatorischen Erstellung eines std::string-Objekts.

Nach der Auflösung von LWG-Problem 471 muss eine abgeleitete Standard-Ausnahmeklasse einen öffentlich zugänglichen Kopierkonstruktor haben. Dieser kann implizit definiert werden, solange die durch what() erhaltenen erklärenden Zeichenketten für das ursprüngliche und das kopierte Objekt gleich sind.

std::out_of_range::operator=

out_of_range& operator=( const out_of_range& other );		(noexcept seit C++11)

Weist den Inhalt dem von other zu. Wenn *this und other beide den dynamischen Typ std::out_of_range haben, dann ist std::strcmp(what(), other.what()) == 0 nach der Zuweisung. Aus dem Kopierzuweisungsoperator kann keine Ausnahme geworfen werden.

Parameter

Sonstiges

-

ein anderes Ausnahmeobjekt zum Zuweisen

Rückgabewert

*this

Anmerkungen

Nach der Auflösung von LWG-Problem 471 muss eine abgeleitete Standard-Ausnahmeklasse einen öffentlich zugänglichen Kopierzuweisungsoperator haben. Dieser kann implizit definiert werden, solange die durch what() erhaltenen erklärenden Zeichenketten für das ursprüngliche und das zugewiesene Objekt gleich sind.

Abgeleitet von std::logic_error

Abgeleitet von std::exception

Memberfunktionen

(Destruktor) [virtuell]	zerstört das Ausnahmeobjekt (virtuelle öffentliche Memberfunktion von std::exception)
what [virtuell]	gibt einen erklärenden String zurück (virtuelle öffentliche Memberfunktion von std::exception)

Hinweise

Die Standard-Fehlerbedingung std::errc::result_out_of_range weist typischerweise auf die Bedingung hin, dass das Ergebnis und nicht die Eingabe außerhalb des Bereichs liegt, und steht in engerem Zusammenhang mit std::range_error und ERANGE.

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 254	C++98	Der Konstruktor, der const char* akzeptiert, fehlte	hinzugefügt
LWG 471	C++98	die erklärenden Zeichenketten von std::out_of_range's Kopien waren implementierungsabhängig	sie sind identisch mit der des ursprüngliches std::out_of_range-Objekt

Siehe auch

at	greift mit Grenzwertprüfung auf das angegebene Zeichen zu (public member function of std::basic_string<CharT,Traits,Allocator>)
at	greift mit Grenzwertprüfung auf das angegebene Zeichen zu (public member function of std::basic_string_view<CharT,Traits>)
at	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::deque<T,Allocator>)
at	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::map<Key,T,Compare,Allocator>)
at	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::unordered_map<Key,T,Hash,KeyEqual,Allocator>)
at	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::vector<T,Allocator>)
at	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::array<T,N>)
at (C++26)	Greift mit Überprüfung auf ein bestimmtes Element zu (public member function of std::span<T,Extent>)