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

CKTIS / C++

static_assert — uma asserção em tempo de compilação

static_assert verifica uma condição constante durante a compilação. Uma condição falsa fora do contexto da definição de um modelo torna o programa mal formado e exige um diagnóstico. Um literal de cadeia opcional descreve a suposição violada.

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

Sintaxe

static_assert(condition);
static_assert(condition, "message");

static_assert é uma declaração que verifica uma condição durante a compilação. Após a conversão contextual para bool, a condição tem de ser uma expressão constante. A asserção não tem efeito se a condição tiver o valor true ou for avaliada no contexto da definição de um modelo, mesmo que nesse contexto tenha o valor false. Nos restantes casos, uma condição falsa torna o programa mal formado e exige um diagnóstico. Assim, não é exigido um diagnóstico para static_assert(false); num modelo se essa asserção nunca for instanciada.

C++23 suporta as formas static_assert(condition); e static_assert(condition, "message");. A mensagem é um literal de cadeia opcional, não texto calculado durante a execução. A declaração termina com ponto e vírgula. Pode surgir, entre outros locais, numa classe; nesse caso, não introduz nem um membro de dados nem uma função-membro.

O exemplo verifica se capacity é positivo e par. Alterá-lo para 7 viola a segunda asserção. Não se deve esperar que todos os compiladores formulem o diagnóstico da mesma forma.

Esta entrada diz respeito a C++23. O site indicado publica um rascunho em evolução, não um texto C++23 fixo; as extensões posteriores das mensagens não são aqui incluídas. Uma opção do compilador no repositório não certifica o ambiente de produção.

Exemplos

constexpr int capacity = 8;
static_assert(capacity > 0, "capacity must be positive");
static_assert(capacity % 2 == 0);

int main() {
    return 0;
}

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