Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

consteval — funkcje natychmiastowe

consteval deklaruje funkcję natychmiastową: jej wywołania wymagają obliczenia stałego, z wyjątkami pozwalającymi składać takie obliczenia. W odróżnieniu od constexpr nie zapewnia zwykłej ścieżki wykonania funkcji w czasie działania programu. if consteval rozróżnia kontekst obliczania stałego od wykonania w czasie działania.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

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

consteval służy do deklarowania funkcji i szablonów funkcji, nie zmiennych. Deklaruje funkcję natychmiastową. Zwykłe, potencjalnie wykonywane wywołanie spoza kontekstu funkcji natychmiastowej musi być wyrażeniem stałym; nie wystarczy, że optymalizator potrafi obliczyć wynik wcześniej. constexpr pozwala natomiast tej samej funkcji uczestniczyć zarówno w obliczaniu stałym, jak i w wykonaniu w czasie działania programu.

Wewnątrz funkcji natychmiastowej można przekazywać parametry do kolejnych funkcji natychmiastowych: wymaganie obliczenia stałego dotyczy otaczającego wywołania natychmiastowego. Parametr nie staje się przez to zmienną constexpr. Także wynik consteval można zapisać w zwykłej, modyfikowalnej zmiennej — ograniczenie dotyczy obliczenia, nie późniejszej zmienności wyniku.

if consteval wybiera pierwszy blok w kontekście jawnego obliczania stałego (manifestly constant-evaluated context), a blok else w pozostałych przypadkach. Pierwszy blok jest więc wybierany także podczas próbnego obliczania stałego niektórych inicjalizatorów, które nie muszą być wyrażeniami stałymi. Pierwszy blok jest kontekstem funkcji natychmiastowej, więc square(x) w evaluate jest dozwolone. Obie gałęzie wymagają klamer. Nie jest to if constexpr: nie odrzuca gałęzi podczas konkretyzacji szablonu na podstawie warunku stałego.

W przykładzie evaluate(6) jest obliczane jako stała, a evaluate(x) korzysta ze ścieżki czasu działania. Bezpośrednie square(x) w main jest niedozwolone, ponieważ odczyt tej lokalnej zmiennej nie jest wyrażeniem stałym. Wszystkie deklaracje tej samej funkcji muszą zachować specyfikator consteval; nie wolno łączyć go z constexpr w jednej deklaracji. Źródłem jest rozwijany szkic standardu, nie zamrożone wydanie C++23; przykład przeznaczono do lokalnej weryfikacji w trybie C++23, bez poświadczenia środowiska produkcyjnego.

Przykłady

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

Wynik

36 49

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła