WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

requires — Constraints und Anforderungsprüfung

Das Schlüsselwort requires leitet entweder eine Klausel ein, die eine Deklaration einschränkt, oder einen Ausdruck, der Anforderungen an Typen und Operationen prüft. Wer diese Verwendungen unterscheidet, kann Templates schreiben, deren Verfügbarkeit von den Fähigkeiten des übergebenen Typs abhängt.

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

Syntax

template<class T> requires Constraint<T> void f(T);
template<class T> void f(T) requires Constraint<T>;
requires (T x) { x + x; typename T::value_type; { x + x } noexcept -> ResultConcept; requires Constraint<T>; }

requires hat zwei Hauptverwendungen. Eine requires-Klausel legt die Einschränkung einer Deklaration fest: Sie kann auf die Template-Parameterliste folgen oder als abschließende Klausel einer Funktion erscheinen. Nicht erfüllte Constraints schließen eine Funktion bei der Überladungsauflösung aus den zulässigen Kandidaten aus; sie wählen keinen Laufzeit-Zweig aus.

Ein requires-Ausdruck, requires (T x) { ... }, ergibt einen Wert vom Typ bool; seine Parameterliste ist optional. Lokale Parameter dienen nur der Notation von Anforderungen – sie erzeugen keine Objekte. In requires requires (T x) { x + x; } beginnt das erste requires eine Klausel und das zweite einen Ausdruck.

Innerhalb der geschweiften Klammern gibt es vier Arten von Anforderungen: Eine einfache Anforderung x + x; prüft, ob ein Ausdruck gültig ist; eine Typanforderung typename T::value_type; prüft einen Typnamen; eine zusammengesetzte Anforderung { x + x } noexcept -> ResultConcept; prüft, ob der Ausdruck gültig ist, ob er nicht als potenziell ausnahmeauslösend eingestuft wird und ob decltype((x + x)) das Konzept erfüllt; eine verschachtelte Anforderung requires Constraint<T>; verlangt, dass ein Constraint erfüllt ist. Sowohl noexcept als auch -> ResultConcept sind optional. Die noexcept-Prüfung richtet sich danach, wie der Ausdruck nach den Sprachregeln eingestuft wird, nicht danach, ob bei der Ausführung tatsächlich eine Ausnahme ausgelöst werden kann. Ein als noexcept deklarierter überladener Operator kann in seinem Funktionsrumpf eine Ausnahme auslösen; verlässt eine Ausnahme den Operator, wird std::terminate aufgerufen. Operanden einfacher und zusammengesetzter Anforderungen werden nicht ausgewertet; x == x; allein verlangt kein Ergebnis true.

Ein Substitutionsfehler im unmittelbaren Kontext der Anforderungen eines Templates kann false statt eines Kompilierungsfehlers ergeben. Dies ist kein allgemeiner Mechanismus zur Unterdrückung von Fehlern: Eine ungültige Anforderung außerhalb der Deklaration einer Template-Entität macht das Programm fehlerhaft. Würde das Einsetzen von Template-Argumenten in eine Anforderung immer zu einem Substitutionsfehler führen, ist das Programm fehlerhaft, ohne dass eine Diagnose erforderlich ist. Eine nicht erfüllte Anforderung ist für sich genommen kein Substitutionsfehler: Eine verschachtelte Anforderung requires false; kann zulässigerweise bewirken, dass ein requires-Ausdruck bei jeder Substitution false ergibt.

Im Beispiel enthält das Konzept Addable einen requires-Ausdruck, während add eine requires Addable<T>-Klausel hat. Die static_assert-Prüfungen umfassen einen unterstützten Typ, einen nicht unterstützten Typ und das Additionsergebnis. Dieser Eintrag bezieht sich auf C++23; das bereitgestellte Dokument ist ein fortlaufend bearbeiteter Arbeitsentwurf und keine unveränderliche C++23-Veröffentlichung.

Beispiele

#include <iostream>

template<class T>
concept Addable = requires(T a, T b) {
    a + b;
};

template<class T>
requires Addable<T>
constexpr auto add(T a, T b) {
    return a + b;
}

struct NoAdd {};

static_assert(Addable<int>);
static_assert(!Addable<NoAdd>);
static_assert(add(2, 3) == 5);

int main() {
    std::cout << add(2, 3) << '\n';
}

Ergebnis

5

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