WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

static_assert — Compilezeitprüfung

static_assert prüft eine Bedingung während der Kompilierung und nicht während der Programmausführung. In C23 ist es ein Schlüsselwort, keine Funktion; die Meldung ist optional.

Version: C23; repository compiler flag, production runtime not attested

Syntax

static_assert(constant-expression, string-literal);
static_assert(constant-expression);

static_assert ist eine Deklaration, die mit einem Semikolon endet. <assert.h> wird dafür nicht benötigt. Die Bedingung muss ein ganzzahliger konstanter Ausdruck mit einem Wert ungleich null sein; eine gewöhnliche Laufzeitvariable reicht nicht aus.

Bei einer Bedingung mit dem Wert null ist eine Compilerdiagnose erforderlich. Die optionale Meldung ist ein Zeichenkettenliteral. Eine erfolgreiche Assertion führt keine Operation aus; anders als assert hängt sie nicht von NDEBUG ab.

Das Beispiel prüft, ob CAPACITY positiv und gerade ist, und gibt anschließend OK aus. Es setzt Unterstützung für C23 voraus; eine Compileroption im Repository belegt nicht, welche Umgebung in der Produktion eingesetzt wird.

Beispiele

#include <stdio.h>

enum { CAPACITY = 16 };
static_assert(CAPACITY > 0, "CAPACITY must be positive");
static_assert(CAPACITY % 2 == 0);

int main(void)
{
    puts("OK");
    return 0;
}

Ergebnis

OK

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