Displays a message box when a logical expression evaluates to False (.F.).
When the condition stipulated in the ASSERT command evaluates to False (.F.), an assert message box displays and echoes to the Debug Output window in the Debugger.
ASSERT is disregarded in applications you distribute.
Specifies the logical expression to evaluate. If lExpression evaluates to a logical False (.F.), a debugging dialog box displays. If lExpression evaluates to a logical True (.T.), the dialog box does not display.
Specifies the text to display in the debugging dialog box. If you omit cMessageText, the default text displays and indicates the line number on which the assertion failed and the procedure containing the assertion.
You can specify whether assert messages display by setting the SET ASSERTS command. For more information, see.
The message box that displays contains Debug, Cancel, Ignore, and Ignore All buttons. The following table describes the action performed when choosing each button.
Suspends program execution and displays the Debugger window with the Trace window active.
Ends program execution.
Continues program execution with the line following the ASSERT command.
Continues program execution with the line following the ASSERT command and sets SET ASSERTS to OFF. Disregards subsequent ASSERT commands until SET ASSERTS is set to ON.
Suppose you create a function that expects a nonzero parameter value. The following line of code in the function alerts you if the value of the parameter is 0:
ASSERT nParm != 0 MESSAGE "Received a parameter of 0"