while

Denotes the beginning of a while/end while loop. Evaluates a conditional expression to determine whether execution is to continue with the action lines directly below it, or with the lines following the matching end while.
NameDescriptionTypeModifier
condition to run

Expression which, when evaluated to True, allows control to proceed to the succeeding action lines. When evaluated to False, control passes to the first action line following the associated end while.

StringNone
None
This action may be used within the following project items: test modules and user-defined actions.
The following settings are applicable to this action: remove double quotes from cells.
                                
                                    	name	value
local variable	temp count	1
	&nbsp	
&nbsp		
	condition to run	
while	#temp count<10	
&nbsp		
	text	
report	#temp count	
	&nbsp	
	name	value
local variable	temp count	#temp count+1
&nbsp		
	&nbsp	
	condition	
if	#temp count=2	
&nbsp		
exit loop		

&nbsp		
end if		
&nbsp		
end while		

                                
                            
  • If condition to run evaluates to True, execution returns to the first action line below the associated repeat action line. (That is, another iteration of the repeat/until loop is begun.) If False, execution continues with the lines below the until.
  • This action ignores letter case for values of True and False, and is unaffected by the current state of the case sensitive built-in setting.

  • It is acceptable to use numeric expressions in the condition to run argument. TestArchitect treats the value 0 as False, and 1 as True. Note that an error is generated for any other numeric value.

  • The following operators may be used within an expression in the condition to run argument:


    Table 1. Comparison operators

    PrecedenceComparison operatorMeaning
    4=equal to
    4<>not equal to
    4>greater than
    4>=greater than or equal to
    4<less than
    4<=less than or equal to


    Table 2. Logical operators

    PrecedenceLogical operatorMeaning
    5notValue is TRUE if its operand is FALSE.
    6andValue is TRUE if and only if both sides of the and operator are TRUE.
    7orValue is TRUE if either side of the or operator is TRUE.


    Notes: 
    For the full list of operator precedence, see here.
  • Be careful when using while/end while loops, and in the expressions you use for condition to run. An infinite loop may cause the TA Playback tool to hang.
  • To exit a while/end while loop from within the block of action lines, use the built-in action exit loop.

Copyright © 2024 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1 (650) 572-1400