CKTIS / C++
std::logic_error — eccezione per errori di logica del programma
std::logic_error, dichiarata in <stdexcept>, rappresenta errori nella logica interna di un programma, come la violazione di precondizioni o invarianti di classe. Memorizza un messaggio accessibile tramite what() e deriva da std::exception.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <stdexcept>
/* Constructor declarations from std::logic_error (C++23 synopsis excerpt):
namespace std {
class logic_error : public exception {
public:
explicit logic_error(const std::string& what_arg);
explicit logic_error(const char* what_arg);
// Other members omitted.
};
}
*/
void f() {
throw std::logic_error("message");
}std::logic_error è una classe di eccezione dichiarata in <stdexcept> che deriva pubblicamente da std::exception. Rappresenta errori nella logica del programma che, in teoria, si potrebbero evitare, per esempio chiamando un’operazione prima della configurazione necessaria. Non indica un errore di compilazione: questa eccezione può essere lanciata durante l’esecuzione del programma.
I suoi costruttori accettano un messaggio come const std::string& oppure const char* e sono explicit. Il membro what() rende accessibile il testo del messaggio. Lancia l’eccezione per valore e intercettala con const std::logic_error&, come nell’esempio.
std::invalid_argument, std::domain_error, std::length_error e std::out_of_range sono classi derivate; scegli un tipo più specifico quando è adatto all’errore. std::runtime_error costituisce un ramo distinto per gli errori legati a eventi esterni alla logica del programma. La violazione di una precondizione non garantisce di per sé il lancio di una std::logic_error: l’esempio rileva esplicitamente il problema ed esegue throw.
L’esempio è pensato per la compilazione in modalità C++23. Il sito fornito presenta una bozza di lavoro in evoluzione, non il testo definitivo di C++23; i costruttori constexpr che vi compaiono non sono qui considerati funzionalità di C++23. Il comportamento in esecuzione in un ambiente di produzione non è stato attestato.
Esempi
#include <iostream>
#include <stdexcept>
void start(bool configured) {
if (!configured) {
throw std::logic_error("configuration required");
}
}
int main() {
try {
start(false);
} catch (const std::logic_error& error) {
std::cout << error.what() << '\n';
}
}
Risultato
configuration required
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.