WHILE

From ICE Enterprises
Jump to navigation Jump to search

implements a logical do-while loop function in a macro

 
[VALUE_1]   Left side of expression
[TEST]      Logical test to be performed
[VALUE_2]   Right side of expression
<...>	    More expressions using AND/OR 

While the logical expression is true, the statements in the range of the
WHILE-ENDWHILE loop are executed.   

All of the logical tests available with IF are available for WHILE.

Examples:
  The following example samples a large data file for frequency components. 

    STATUS large_file no_elements
    CALC no_elements no_elements 1024 -
    RESULT index 1
    WHILE index LT no_elements
      FFT large_file tmp index 1024
      STATISTICS tmp ,,,,,,,, max_index
      CALC index index 100000 +
    ENDWHILE
    
  While loops can be nested any number of levels deep.  

Switches:
  /TOL=n - The tolerance for the EQT test [DEF=1e-6]
  /CS    - Perform a CASE SENSITIVE test. For EQS, EQSS and SUBS only.
           [DEF=Ignores case]

SEE ALSO:  ENDWHILE, BREAK, IF, GOTO, nxm.sys.lib.Args