WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

static_assert — Compilezeitassertion

static_assert prüft eine konstante Bedingung während der Übersetzung des Programms, statt sie zur Laufzeit zu testen.

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

Syntax

static_assert(integer_constant_expression, "message");
static_assert(integer_constant_expression);
_Static_assert(integer_constant_expression, "message");
_Static_assert(integer_constant_expression);

static_assert verlangt einen ganzzahligen konstanten Ausdruck. Ein Wert ungleich null erfüllt die Bedingung; bei null ist eine Diagnose erforderlich. Die Deklaration führt keinen Test zur Laufzeit aus.

In C23 ist die Meldung ein optionales Zeichenkettenliteral; sie sollte in der Diagnose einer fehlgeschlagenen Assertion erscheinen. Das Semikolon ist erforderlich. static_assert ist ein Schlüsselwort und benötigt keinen Header. _Static_assert hat dieselbe Bedeutung, ist in C23 jedoch eine veraltete Schreibweise.

Im Beispiel ist CAPACITY eine Aufzählungskonstante. Beide Assertions sind erfüllt; eine Änderung des Werts auf 7 verletzt die zweite.

Beispiele

enum { CAPACITY = 8 };

static_assert(CAPACITY > 0, "CAPACITY must be positive");
_Static_assert(CAPACITY % 2 == 0);

int main(void)
{
    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