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

CKTIS / C++

std::logic_error — exceção por erro de lógica do programa

std::logic_error, declarada em <stdexcept>, representa erros na lógica interna de um programa, como a violação de pré-condições ou invariantes de classe. Guarda uma mensagem acessível através de what() e deriva de std::exception.

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

Sintaxe

#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 é uma classe de exceção declarada em <stdexcept> que deriva publicamente de std::exception. Representa erros na lógica do programa que, em teoria, poderiam ser evitados, como chamar uma operação antes de efetuar a configuração necessária. Não significa um erro de compilação: esta exceção pode ser lançada durante a execução do programa.

Os seus construtores aceitam uma mensagem como const std::string& ou const char* e são explicit. O membro what() disponibiliza o texto da mensagem. Lança a exceção por valor e captura-a através de const std::logic_error&, como no exemplo.

std::invalid_argument, std::domain_error, std::length_error e std::out_of_range são classes derivadas; escolhe um tipo mais específico quando for adequado ao erro. std::runtime_error constitui um ramo separado para erros associados a acontecimentos externos à lógica do programa. A violação de uma pré-condição não garante, por si só, o lançamento de uma std::logic_error: o exemplo deteta explicitamente o problema e executa throw.

O exemplo destina-se a compilação no modo C++23. O site indicado apresenta um projeto de trabalho em evolução, e não o texto fixo de C++23; os construtores constexpr aí apresentados não são aqui considerados funcionalidades de C++23. O comportamento em tempo de execução em produção não foi atestado.

Exemplos

#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';
    }
}

Resultado

configuration required

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