CKTIS / C++
std::out_of_range — argumento fuera del rango esperado
std::out_of_range, declarado en <stdexcept>, indica que un valor de argumento está fuera del rango esperado. Contiene un mensaje accesible mediante what() y deriva de std::logic_error.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }std::out_of_range es una clase de excepción declarada en <stdexcept> para indicar que un valor de argumento está fuera del rango esperado. Deriva públicamente de std::logic_error e indirectamente de std::exception.
Sus constructores aceptan un mensaje como const std::string& o const char*. El miembro what() expone un texto que coincide con el mensaje proporcionado. Captura la excepción mediante const std::out_of_range&. No la confundas con std::range_error, que describe errores de rango en cálculos internos y deriva de std::runtime_error.
En el ejemplo, checked_score comprueba explícitamente el intervalo [0, 100] y rechaza 101. La existencia de esta clase de excepción no añade comprobaciones de rango a las operaciones. El ejemplo está dirigido a C++23; el borrador de trabajo actual también incluye cambios posteriores, por lo que los constructores constexpr que aparecen en él no están garantizados en C++23.
Ejemplos
#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';
}
}
Resultado
score must be in [0, 100]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.