CKTIS / C++
std::out_of_range — argument buiten het verwachte bereik
std::out_of_range, gedeclareerd in <stdexcept>, meldt een argumentwaarde buiten het verwachte bereik. De uitzondering bevat een bericht dat via what() beschikbaar is en is afgeleid van std::logic_error.
Versie: 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 is een uitzonderingsklasse die is gedeclareerd in <stdexcept> en bedoeld is om een argumentwaarde buiten het verwachte bereik te melden. De klasse is publiek afgeleid van std::logic_error en indirect van std::exception.
De constructors accepteren een bericht als const std::string& of const char*. De methode what() geeft de tekst van het opgegeven bericht terug. Vang de uitzondering op als const std::out_of_range&. Verwar deze niet met std::range_error, die bereikfouten bij interne berekeningen beschrijft en is afgeleid van std::runtime_error.
In het voorbeeld controleert checked_score expliciet het interval [0, 100] en wijst 101 af. Het bestaan van deze uitzonderingsklasse voegt geen bereikcontroles toe aan bewerkingen. Het voorbeeld is bedoeld voor C++23; het huidige werkdocument bevat ook latere wijzigingen. De getoonde constexpr-constructors zijn daarom geen garantie van C++23.
Voorbeelden
#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';
}
}
Resultaat
score must be in [0, 100]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.