Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::out_of_range — argument en dehors de la plage attendue

std::out_of_range, déclaré dans <stdexcept>, signale une valeur d’argument en dehors de la plage attendue. Il transporte un message accessible avec what() et dérive de std::logic_error.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }

std::out_of_range est une classe d’exception déclarée dans <stdexcept> pour signaler une valeur d’argument en dehors de la plage attendue. Elle dérive publiquement de std::logic_error et indirectement de std::exception.

Ses constructeurs acceptent un message sous la forme const std::string& ou const char*. Le membre what() expose un texte correspondant au message fourni. Interceptez l’exception par const std::out_of_range&. Ne la confondez pas avec std::range_error, qui décrit des erreurs de plage dans les calculs internes et dérive de std::runtime_error.

Dans l’exemple, checked_score vérifie explicitement l’intervalle [0, 100] et rejette 101. L’existence de cette classe d’exception n’ajoute pas de vérification de plage aux opérations. L’exemple vise C++23 ; le projet de norme actuel comprend également des modifications ultérieures. Les constructeurs constexpr qui y sont montrés ne sont donc pas garantis par C++23.

Exemples

#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';
    }
}

Résultat

score must be in [0, 100]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources