WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

consteval — unmittelbare Funktionen

consteval deklariert eine unmittelbare Funktion: Ihre Aufrufe müssen konstant ausgewertet werden, mit Ausnahmen, die solche Berechnungen miteinander verknüpfen lassen. Anders als constexpr bietet es keinen gewöhnlichen Laufzeit-Ausführungspfad für die Funktion. if consteval unterscheidet Kontexte konstanter Auswertung von Laufzeitauswertung.

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

Syntax

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

consteval gilt für Deklarationen von Funktionen und Funktionsvorlagen, nicht für Variablen. Es deklariert eine unmittelbare Funktion. Ein gewöhnlicher, möglicherweise ausgewerteter Aufruf außerhalb eines unmittelbaren Funktionskontexts muss ein konstanter Ausdruck sein; es reicht nicht, dass ein Optimierer das Ergebnis vorab berechnen könnte. constexpr erlaubt dagegen, dass dieselbe Funktion sowohl an konstanter Auswertung als auch an der Laufzeitausführung teilnimmt.

Innerhalb einer unmittelbaren Funktion können Parameter an weitere unmittelbare Funktionen übergeben werden: Die Forderung nach einem konstanten Ausdruck gilt für den umschließenden unmittelbaren Aufruf. Dadurch wird ein Parameter nicht zu einer constexpr-Variablen. Auch kann das Ergebnis von consteval einer gewöhnlichen veränderlichen Variablen zugewiesen werden — die Einschränkung betrifft die Berechnung, nicht die spätere Veränderbarkeit des Ergebnisses.

if consteval wählt seinen ersten Block in einem Kontext, der nachweislich konstant ausgewertet wird, andernfalls den else-Block. Der erste Block ist ein unmittelbarer Funktionskontext, daher ist square(x) innerhalb von evaluate zulässig. Beide Zweige benötigen geschweifte Klammern. Dies ist nicht if constexpr: Dabei wird während der Instanziierung einer Vorlage nicht anhand einer konstanten Bedingung ein Zweig verworfen.

Im Beispiel wird evaluate(6) konstant ausgewertet, während evaluate(x) den Laufzeitpfad verwendet. Ein direkter Aufruf von square(x) in main ist unzulässig, weil das Lesen dieser lokalen Variablen kein konstanter Ausdruck ist. Alle Deklarationen derselben Funktion müssen den Spezifizierer consteval beibehalten; er kann in einer Deklaration nicht mit constexpr kombiniert werden. Die Quelle ist ein fortlaufend entwickelter Arbeitsentwurf, keine festgeschriebene C++23-Ausgabe; das Beispiel ist für die lokale Überprüfung im C++23-Modus vorgesehen, ohne dass eine Produktionslaufzeit bestätigt wird.

Beispiele

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

Ergebnis

36 49

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen