$ASSERTS

This metacommand enables debug tests with the _ASSERT statement.

Syntax

$ASSERTS

$ASSERTS:CONSOLE

Description

• If this metacommand is in your program and any of the _ASSERT checks will fail, then the program will stop with an "_ASSERT failed" error.
• Detailed error messages passed to the _ASSERT statement will displayed in the console window, but only if $ASSERTS:CONSOLE is used.

Note

* This metacommand is some kind of main switch to perform debug tests during developmet. Later just remove this metacommand to compile your program without debugging code, all the _ASSERT statements may remain in the code for later debugging sessions, they are simply ignored without this metacommand.

Availability

• QB64 2.1 and up (QB64 Team)
• QBPE 0.5 and up (QB64 Phoenix Edition)

Examples

Example

Adding test checks for parameter inputs in a function.

$ASSERTS:CONSOLE DO a = INT(RND * 10) b$ = myFunc$(a) PRINT a, , b$ _LIMIT 3 LOOP UNTIL _KEYHIT FUNCTION myFunc$ (value AS SINGLE) _ASSERT value > 0, "Value cannot be zero" _ASSERT value <= 10, "Value cannot exceed 10" IF value > 1 THEN plural$ = "s" myFunc$ = STRING$(value, "*") + STR$(value) + " star" + plural$ + " :-)" END FUNCTION

See also

• _ASSERT
• $CHECKING
• Relational Operations

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link