Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti