WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

assert — C23-Makro

Das Makro `assert(...)` aus `<assert.h>` prüft einen skalaren Ausdruck: wahr bewirkt nichts, falsch gibt Diagnoseinformation aus und ruft `abort()` auf. Es liefert keinen Wert.

Version: C23

Syntax

assert(scalar-expression);

Das Makro assert(...) aus <assert.h> prüft einen skalaren Ausdruck: wahr bewirkt nichts, falsch gibt Diagnoseinformation aus und ruft abort() auf. Es liefert keinen Wert.

Es dokumentiert und prüft Programminvarianten, nicht fehlerhafte Benutzereingaben. Das Beispiel prüft das Ergebnis von square(4) tatsächlich, bevor es fortfährt.

Ist NDEBUG vor dem Header definiert, verschwindet die Prüfung und das Argument wird nicht ausgewertet. Der Ausdruck darf daher keine benötigten Nebenwirkungen enthalten; Laufzeitfehler brauchen ausdrückliche Behandlung auch im Produktions-Build.

Beispiele

#include <assert.h>
#include <stdio.h>

static int square(int value) { return value * value; }

int main(void) {
    assert(square(4) == 16);
    puts("assertion passed");
    return 0;
}

Ergebnis

assertion passed

Es dokumentiert und prüft Programminvarianten, nicht fehlerhafte Benutzereingaben. Das Beispiel prüft das Ergebnis von `square(4)` tatsächlich, bevor es fortfährt.

Quellen