Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes