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

CKTIS / C++

std::runtime_error — excepción de error en tiempo de ejecución

std::runtime_error, declarada en <stdexcept>, informa de errores detectables durante la ejecución del programa. Contiene un mensaje accesible mediante what() y deriva públicamente de std::exception.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <stdexcept>

// C++23
explicit runtime_error(const std::string& what_arg);
explicit runtime_error(const char* what_arg);

throw std::runtime_error("Service unavailable");

std::runtime_error es una clase de excepción de <stdexcept> que deriva públicamente de std::exception. Representa errores que, en principio, solo pueden detectarse durante la ejecución, como la indisponibilidad de un servicio. En cambio, std::logic_error describe errores en la lógica interna del programa que, en teoría, se pueden evitar.

Sus constructores aceptan un mensaje what_arg de tipo const std::string& o const char*. La función what() devuelve un puntero a un texto terminado en un carácter nulo. Tras la construcción, se cumple strcmp(what(), what_arg.c_str()) == 0 para la primera sobrecarga y strcmp(what(), what_arg) == 0 para la segunda. Si el std::string proporcionado contiene un carácter nulo interno ('\0'), no se garantiza que what() conserve los caracteres que le siguen. La función what() no lanza excepciones. El puntero devuelto sigue siendo válido hasta que se destruye el objeto de excepción o se llama a una de sus funciones miembro no constantes. Si necesita conservar el texto durante más tiempo, cópielo en un std::string.

Use throw para lanzar la excepción y captúrela mediante const std::runtime_error& para evitar copiarla. La mera creación del objeto no lo lanza como excepción. En el ejemplo, false simula de forma determinista que un servicio no está disponible, y el bloque catch imprime Service unavailable seguido de un salto de línea.

Esta entrada se refiere a C++23. El borrador de trabajo proporcionado evoluciona y también muestra declaraciones constexpr que no deben considerarse garantías de C++23. Una opción del compilador en el repositorio no demuestra el comportamiento en tiempo de ejecución en producción; el ejemplo requiere verificación local.

Ejemplos

#include <iostream>
#include <stdexcept>

void access_service(bool available) {
    if (!available) {
        throw std::runtime_error("Service unavailable");
    }
}

int main() {
    try {
        access_service(false);
    } catch (const std::runtime_error& error) {
        std::cout << error.what() << '\n';
    }
}

Resultado

Service unavailable

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