WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen