WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

static_assert — eine Compilezeit-Assertion

static_assert prüft während der Kompilierung eine konstante Bedingung. Ist die Bedingung außerhalb des Kontexts einer Template-Definition falsch, ist das Programm fehlerhaft und eine Diagnose erforderlich. Ein optionales Zeichenkettenliteral beschreibt die verletzte Annahme.

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

Syntax

static_assert(condition);
static_assert(condition, "message");

static_assert ist eine Deklaration, die eine Bedingung während der Kompilierung prüft. Nach der kontextuellen Konvertierung zu bool muss die Bedingung ein konstanter Ausdruck sein. Die Assertion hat keine Wirkung, wenn die Bedingung true ergibt oder im Kontext einer Template-Definition ausgewertet wird, selbst wenn sie dort false ergibt. Andernfalls macht eine falsche Bedingung das Programm fehlerhaft und erfordert eine Diagnose. Für static_assert(false); in einem Template ist daher keine Diagnose erforderlich, wenn die Assertion nie instanziiert wird.

C++23 unterstützt die Formen static_assert(condition); und static_assert(condition, "message");. Die Meldung ist ein optionales Zeichenkettenliteral und kein zur Laufzeit berechneter Text. Die Deklaration endet mit einem Semikolon. Sie kann unter anderem in einer Klasse stehen; dort führt sie weder ein Datenelement noch eine Elementfunktion ein.

Das Beispiel prüft, ob capacity positiv und gerade ist. Eine Änderung auf 7 verletzt die zweite Assertion. Es ist nicht zu erwarten, dass die Diagnose bei allen Compilern gleich formuliert ist.

Dieser Eintrag bezieht sich auf C++23. Die angegebene Website veröffentlicht einen fortlaufend weiterentwickelten Entwurf und keinen eingefrorenen C++23-Text; neuere Erweiterungen für Meldungen sind hier nicht berücksichtigt. Eine Compiler-Option im Repository bestätigt nicht die Produktionsumgebung.

Beispiele

constexpr int capacity = 8;
static_assert(capacity > 0, "capacity must be positive");
static_assert(capacity % 2 == 0);

int main() {
    return 0;
}

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