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.