Assert
Debugging macro that halts program execution if an expression is evaluated to `0` (false).
Syntax
`
#define Assert(expression) If (expression) = 0 Then : fb_Assert( __FILE__, __LINE__, __FUNCTION__, #expression ) : End If
`
Usage
`
Assert( expression )
`
Parameters
`expression`
Any valid conditional/numeric expression. If `expression` evaluates to `0` (i.e. "false"), execution is halted.
Description
The `Assert` macro is intended for use in debugging and works only if the `-g` option is selected in the FBC command line. In this case it prints an error message and stops the program execution if `expression` evaluates to `0`.
Its normal use is to check the correct value of the variables during debugging.
If `-g` is not passed to fbc, the macro does not generate any code, and has no effect.
Note: If an `Assert` fails while the program is in a graphics `Screen`, the error message will not be visible as it will be printed to the graphics screen, which will be closed immediately after.
Example
`
Sub foo
Dim a As Integer
a=0
Assert(a=1)
End Sub
foo
'' If -g is used this code stops with: test.bas(3): assertion failed at FOO: a=1
`
Dialect Differences

- Not available in the -lang qb dialect unless referenced with the alias `__ASSERT`.

Differences from QB

- New to FreeBASIC

See also

- `AssertWarn`