until

This macro causes execution to break when expression evaluates to TRUE. It can only be used with the GO and GOSTEP commands to:

• halt execution when the expression passed is TRUE.

• continue execution when the expression passed is FALSE.

Syntax:

int until (expression)
int expression;

where:

expression          An expression that is evaluated to test whether the result is nonzero.

Return Value

int                     One of the following:

0     Indicates that expression is FALSE (zero).

1     Indicates that expression is TRUE (nonzero).

Rules

Any C expression resulting in a value can be used as the argument, expression.

Example

Set temporary breakpoints at line numbers 3 and 17 in the current module, and at the entry point to the function printf. When any of these locations are encountered by the executing program, the debugger will stop and check the until conditional statements. If the variable i is equal to 3 or the variable x is less than y, a break occurs. Otherwise, program execution continues.

GO #3,#17,printf;until(i==3||x<y)