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

CKTIS / C++

consteval — funções imediatas

consteval declara uma função imediata: as suas chamadas exigem avaliação constante, com exceções que permitem compor esses cálculos. Ao contrário de constexpr, não disponibiliza um percurso normal de execução em tempo de execução para a função. if consteval distingue contextos de avaliação constante da avaliação em tempo de execução.

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

Sintaxe

consteval return_type name(parameters) { /* body */ }
if consteval { /* constant evaluation */ } else { /* runtime evaluation */ }

consteval aplica-se a declarações de funções e de modelos de função, não a variáveis. Declara uma função imediata. Uma chamada comum potencialmente avaliada fora de um contexto de função imediata tem de ser uma expressão constante; não basta que um optimizador consiga pré-calcular o resultado. Em contrapartida, constexpr permite que a mesma função participe tanto na avaliação constante como na execução em tempo de execução.

Dentro de uma função imediata, os parâmetros podem ser passados a outras funções imediatas: o requisito de expressão constante aplica-se à chamada imediata envolvente. Isto não transforma um parâmetro numa variável constexpr. O resultado de consteval também pode inicializar uma variável comum e modificável — a restrição diz respeito ao cálculo, não à mutabilidade posterior do resultado.

if consteval selecciona o primeiro bloco num contexto manifestamente avaliado em tempo de compilação e, nos restantes casos, o bloco else. O primeiro bloco é um contexto de função imediata, pelo que square(x) dentro de evaluate é permitido. Ambos os ramos exigem chavetas. Não é if constexpr: não descarta um ramo durante a instanciação de modelos com base numa condição constante.

No exemplo, evaluate(6) é avaliado como constante, enquanto evaluate(x) utiliza o percurso de execução em tempo de execução. Uma chamada directa a square(x) em main é mal formada, porque a leitura dessa variável local não é uma expressão constante. Todas as declarações da mesma função têm de manter o especificador consteval; não pode ser combinado com constexpr numa única declaração. A fonte é um rascunho de trabalho em evolução, não uma edição C++23 congelada; o exemplo destina-se a verificação local em modo C++23, sem atestar um ambiente de produção.

Exemplos

#include <iostream>

consteval int square(int x) {
    return x * x;
}

constexpr int evaluate(int x) {
    if consteval {
        return square(x);
    } else {
        return x * x;
    }
}

int main() {
    constexpr int a = evaluate(6);
    static_assert(a == 36);
    int x = 7;
    std::cout << a << ' ' << evaluate(x) << '\n';
    // square(x); // ill-formed
}

Resultado

36 49

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