ASSERT

Class

Error Handling and Debugging

Purpose

Display a message dialog with options when a condition evaluates to False

Syntax

ASSERT <expL> [MESSAGE <expC>]

See Also

DEBUG, SET ASSERTS, SET COMPILE

Description

The ASSERT command is used for program debugging purposes: to display a message dialog with options when a condition evaluates to False (.F.). The condition is specified in <expL>. An optional message can be specified using the MESSAGE <expC> clause. If no message is specified; the default message is:

Assertion failed on line <#> of
           procedure <prg>.

The dialog has four buttons, offering the following options:

Button	Option
Debug	Suspends program execution and starts the Debugger. The Debug option is only available if the program is being run uncompiled.
Cancel	Stops program execution.
Ignore	Continues program execution.
Ignore All	Continues program execution and issue SET ASSERTS OFF, causing subsequent asserts to be ignored.

If SET ASSERTS is OFF, asserts are ignored. SET ASSERTS is OFF by default.

Example

set asserts on
 
procedure proc1
 
parameters para1, para2, para3
assert pcount() = 3 message [3 parameters required]
// code continues
 
return

Products

Recital Mirage Server, Recital Terminal Developer