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.