WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

assert — Annahmen prüfen und NDEBUG

Das Makro assert aus <cassert> prüft Programmannahmen zur Laufzeit. NDEBUG deaktiviert sowohl die Prüfung als auch die Auswertung der Bedingung. Assertions sind daher kein Ersatz für die Validierung von Eingaben.

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

Syntax

#include <cassert>
assert(condition);

assert(condition) ist ein Makro aus <cassert>, keine Funktion namens std::assert. In C++23 muss das Argument bei aktivierter Prüfung ein Ausdruck mit skalarem Typ sein. Dass sich ein Objekt eines Klassentyps kontextuell in bool umwandeln lässt, garantiert nicht, dass das Makro es akzeptiert. Der Ausdruck wird ausgewertet: Ergibt der Vergleich des Ergebnisses mit null Gleichheit, gibt das Makro eine Diagnose auf dem Standardfehlerstrom aus und ruft abort() auf. Andernfalls wird die Ausführung fortgesetzt. Das Format der Diagnose ist implementierungsabhängig.

Ist NDEBUG definiert, wenn <cassert> eingebunden wird, wertet assert die Bedingung nicht aus und tut nichts. Entscheidend ist allein, dass NDEBUG definiert ist: Auch #define NDEBUG 0 deaktiviert die Prüfung. Lege niemals notwendige Seiteneffekte in die Bedingung. Verwende für die Eingabevalidierung eine gewöhnliche Fehlerbehandlung, die nicht auf diese Weise verschwinden darf.

Dieser Eintrag bezieht sich auf C++23; die bereitgestellte Seite ist ein fortlaufend weiterentwickelter Entwurf und kein unveränderter C++23-Text. Verwende ein Argument; zusätzliche Klammern wie in assert((condition)) verhindern, dass Kommas innerhalb des Ausdrucks als Trennzeichen für Makroargumente behandelt werden. Das Compiler-Flag für C++23 allein bestätigt weder die Einstellung von NDEBUG noch das Laufzeitverhalten in der Produktionsumgebung.

Beispiele

#include <cassert>
#include <iostream>

int main() {
    const int count = 3;
    assert(count > 0);
    std::cout << count << '\n';
}

Ergebnis

3

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