Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

consteval — okamžité funkce

consteval deklaruje okamžitou funkci: její volání vyžadují konstantní vyhodnocení, s výjimkami, které umožňují takové výpočty skládat. Na rozdíl od constexpr neposkytuje funkci běžnou cestu vykonávání za běhu. if consteval rozlišuje kontexty konstantního vyhodnocení od vyhodnocení za běhu.

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

Syntaxe

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

consteval se používá v deklaracích funkcí a šablon funkcí, nikoli proměnných. Deklaruje okamžitou funkci. Běžné potenciálně vyhodnocované volání mimo kontext okamžité funkce musí být konstantním výrazem; nestačí, že optimalizátor dokáže výsledek předem vypočítat. Naproti tomu constexpr umožňuje, aby se stejná funkce účastnila konstantního vyhodnocení i vykonávání za běhu.

Uvnitř okamžité funkce lze parametry předávat dalším okamžitým funkcím: požadavek na konstantní výraz se vztahuje na obklopující okamžité volání. Parametr se tím nestává proměnnou constexpr. Výsledkem consteval lze také inicializovat běžnou měnitelnou proměnnou — omezení se týká výpočtu, nikoli pozdější měnitelnosti výsledku.

if consteval vybere první blok v kontextu, který je zjevně vyhodnocován konstantně, a jinak blok else. První blok je kontextem okamžité funkce, takže square(x) uvnitř evaluate je povoleno. Obě větve vyžadují složené závorky. Nejde o if constexpr: při vytváření instance šablony se na základě konstantní podmínky žádná větev neodstraňuje.

V příkladu se evaluate(6) vyhodnotí jako konstanta, zatímco evaluate(x) používá cestu za běhu. Přímé volání square(x) v main není správně utvořené, protože čtení této lokální proměnné není konstantním výrazem. Všechny deklarace téže funkce musí zachovat specifikátor consteval; v jedné deklaraci jej nelze kombinovat s constexpr. Zdrojem je průběžně vyvíjený pracovní návrh, nikoli zmrazené vydání C++23; příklad je určen k místnímu ověření v režimu C++23, bez potvrzení produkčního běhu.

Příklady

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

Výsledek

36 49

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje