3.2.44. until

Breaks when a given expression evaluates to True.

Syntax

int until (expression)
int expression;

where:

expression

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

Description

This macro causes execution to break when expression is True. The until macro evaluates its argument, expression, to determine if it is True (nonzero) or False (zero). This macro can only be used with the GO command and the GOSTEP command to:

  • halt execution when the expression passed is True

  • continue execution when the expression passed is False.

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 stops then checks 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)

See also

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0175K
Non-Confidential