contents.gifindex.gifprev1.gifnext1.gif

Do_While

Purpose

Provides looping.

Arguments

Do_While(

<condition>
//Must evaluate to True (-1) for the <body> to be executed.
, <body>
//Will be executed as long as <condition> is true and <limit> has not been reached.
, <limit>
//Imposes an upper limit to the number of iterations. A negative number implies that no limit should exist.
)

Notes

The function returns the actual number of iterations which were performed on <body>. Note that <condition> will have one more iteration performed that will <body> if <condition> terminates the loop.

Do_While calls may be nested up to ten levels deep.

The Rules Engine variable Do_While_Cnt can be referenced from within Do_While() to get the iteration count currently in process.

As an example,

Do_While( True, Msgbox(Do_While_Cnt,5 )

Displays five message successive message boxes, counting from 1 to 5.

Example

Delim_Val("A*B*C*D ,2)

Returns: "B"