CKTIS / C++
std::runtime_error — eccezione per errori a runtime
std::runtime_error, dichiarata in <stdexcept>, segnala errori rilevabili durante l’esecuzione del programma. Contiene un messaggio accessibile tramite what() e deriva pubblicamente da std::exception.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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 è una classe di eccezione di <stdexcept> che deriva pubblicamente da std::exception. Rappresenta errori che presumibilmente si possono rilevare solo durante l’esecuzione, per esempio l’indisponibilità di un servizio. Al contrario, std::logic_error descrive errori nella logica interna del programma che, in teoria, si possono prevenire.
I suoi costruttori accettano un messaggio what_arg di tipo const std::string& oppure const char*. La funzione what() restituisce un puntatore a un testo terminato da un carattere nullo. Dopo la costruzione vale strcmp(what(), what_arg.c_str()) == 0 per il primo overload e strcmp(what(), what_arg) == 0 per il secondo. Se lo std::string fornito contiene un carattere nullo interno ('\0'), non è garantito che what() conservi i caratteri successivi. La funzione what() non genera eccezioni. Il puntatore restituito rimane valido fino alla distruzione dell’oggetto eccezione o alla chiamata di una sua funzione membro non const. Per conservare il testo più a lungo, copiatelo in un std::string.
Usate throw per lanciare l’eccezione e intercettatela tramite const std::runtime_error& per evitare una copia. La semplice creazione dell’oggetto non lo lancia come eccezione. Nell’esempio, false simula in modo deterministico un servizio non disponibile e il blocco catch stampa Service unavailable seguito da un a capo.
Questa voce riguarda C++23. La bozza di lavoro fornita è in evoluzione e mostra anche dichiarazioni constexpr che non vanno considerate garanzie di C++23. Un’opzione del compilatore nel repository non dimostra il comportamento a runtime in produzione; l’esempio richiede una verifica locale.
Esempi
#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';
}
}
Risultato
Service unavailable
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.