CKTIS / C++
std::out_of_range — Argument außerhalb des erwarteten Bereichs
std::out_of_range aus <stdexcept> meldet einen Argumentwert außerhalb des erwarteten Bereichs. Die Ausnahme enthält eine über what() abrufbare Meldung und leitet sich von std::logic_error ab.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }std::out_of_range ist eine in <stdexcept> deklarierte Ausnahmeklasse, um einen Argumentwert außerhalb des erwarteten Bereichs zu melden. Sie leitet sich öffentlich von std::logic_error und indirekt von std::exception ab.
Ihre Konstruktoren akzeptieren eine Meldung als const std::string& oder const char*. Die Memberfunktion what() stellt einen Text bereit, der der übergebenen Meldung entspricht. Fangen Sie die Ausnahme mit const std::out_of_range& ab. Verwechseln Sie sie nicht mit std::range_error, das Bereichsfehler bei internen Berechnungen beschreibt und sich von std::runtime_error ableitet.
Im Beispiel prüft checked_score ausdrücklich das Intervall [0, 100] und weist 101 zurück. Die Existenz dieser Ausnahmeklasse fügt Operationen keine Bereichsprüfung hinzu. Das Beispiel ist für C++23 gedacht; der aktuelle Arbeitsentwurf enthält auch spätere Änderungen. Die dort gezeigten constexpr-Konstruktoren sind daher keine C++23-Garantie.
Beispiele
#include <iostream>
#include <stdexcept>
int checked_score(int score) {
if (score < 0 || score > 100) {
throw std::out_of_range("score must be in [0, 100]");
}
return score;
}
int main() {
try {
std::cout << checked_score(101) << '\n';
} catch (const std::out_of_range& e) {
std::cout << e.what() << '\n';
}
}
Ergebnis
score must be in [0, 100]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.