KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen