System.Assert

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Assert(Condition: Boolean; [ Message: String ]); overload;
procedure Assert(Condition: Boolean; [ Message: String ]); overload;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure public System.pas System System

Beschreibung

Prüft, ob ein boolescher Ausdruck wahr ist.

In Delphi können Sie mit Assert testen, ob Bedingungen verletzt werden, die als zutreffend angenommen werden. Assert bietet eine Möglichkeit, eine unerwartete Bedingung zu simulieren und ein Programm anzuhalten, anstatt die Ausführung in unbekannter Konstellation fortzusetzen.

Assert übernimmt als Parameter einen Booleschen Ausdruck und einen optionalen Meldungstext. Wenn der Boolesche Test fehlschlägt, löst Assert eine EAssertionFailed-Exception aus. Wenn ein Meldungstext übergeben wurde, wird das Exception-Objekt mit diesem String erzeugt. Andernfalls wird ein Standardtext angezeigt. Zusätzlich wird der Dateipfad, der Dateiname und die Zeilennummer angegeben, in der Assert fehlgeschlagen ist.

Die Unit SysUtil wandelt Laufzeitfehler in Exceptions um. Wenn SysUtil allerdings nicht in die Anwendung eingebunden ist, wird der Laufzeitfehler 227 ausgegeben, und keine EAssertionFailed-Exception ausgelöst. Dieser Laufzeitfehler hält das Programm an.

In der Regel werden Assertions nicht in Programmversionen verwendet, die zur Auslieferung vorgesehen sind. Deshalb wurden Compiler-Direktiven implementiert, mit denen die Generierung des zugehörigen Quelltextes deaktiviert werden kann:

$ASSERTIONS ON/OFF (lange Form)

$C +/- (kurze Form)

Es handelt sich dabei um globale Optionen, die sich unabhängig von ihrer Position auf die ganze Quelltextdatei auswirken. Der kleinste Gültigkeitsbereich für Assertions ist eine Quelltextdatei. Assertions sind standardmäßig aktiviert.

Siehe auch