$Assertions

Back to local compiler directives.

The local compiler directive $C or $ASSERTIONS:

• is used for error detection;
• determines whether an expression is compiled or not. If the directive is active, then the Assert expression is compiled.

Examples:

...
{$ASSERTIONS ON} 
...
Assert(BooleanExpression, AssertMessage);
...

...
{$C ON} 
...
Assert(BooleanExpression);
...

If the BooleanExpression is false, an optional error message (AssertMessage) is output with the file name, the line number and the address and the program aborts with Runtime error 227. If BooleanExpression is true, program execution continues normally. If assertions are not enabled at compile time, the Assert routine does nothing, and no code is generated for the Assert call.

see also

• $C or $ASSERTIONS: Assertion support in the Programmer’s Guide

From the Free Pascal wiki, page "$Assertions", as it stood on 2021-02-11 after a change by Kai Burghardt, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.