Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::runtime_error — exceção de erro em tempo de execução

std::runtime_error, declarada em <stdexcept>, comunica erros detetáveis durante a execução do programa. Contém uma mensagem acessível através de what() e deriva publicamente de std::exception.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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 é uma classe de exceção de <stdexcept> que deriva publicamente de std::exception. Representa erros que, presumivelmente, só podem ser detetados durante a execução, como a indisponibilidade de um serviço. Em contrapartida, std::logic_error descreve erros na lógica interna do programa que, teoricamente, podem ser evitados.

Os seus construtores aceitam uma mensagem what_arg do tipo const std::string& ou const char*. A função what() devolve um ponteiro para texto terminado por um caráter nulo. Após a construção, verifica-se strcmp(what(), what_arg.c_str()) == 0 para a primeira sobrecarga e strcmp(what(), what_arg) == 0 para a segunda. Se o std::string fornecido contiver um caráter nulo interno ('\0'), não há garantia de que what() preserve os carateres que se lhe seguem. A função what() não lança exceções. O ponteiro devolvido permanece válido até o objeto de exceção ser destruído ou ser chamada uma das suas funções-membro não constantes. Para conservar o texto durante mais tempo, copie-o para um std::string.

Use throw para lançar a exceção e apanhe-a através de const std::runtime_error& para evitar uma cópia. A simples criação do objeto não o lança como exceção. No exemplo, false simula de forma determinística um serviço indisponível e o bloco catch escreve Service unavailable seguido de uma mudança de linha.

Esta entrada destina-se a C++23. O projeto de norma fornecido está em evolução e também apresenta declarações constexpr que não devem ser consideradas garantias de C++23. Uma opção do compilador no repositório não comprova o comportamento em tempo de execução em produção; o exemplo requer verificação local.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes