HELP
An object that activates the data output a
specified number of times.

USE
Use For Range to execute a subthread a
specified number of iterations specified by a
beginning value, ending value, and increment.
Use For Range to generate values that are
evenly distributed between the From and Thru
values.

LOCATION
Flow ==> Repeat ==> For Range

OPEN VIEW PARAMETERS

* From - The beginning value of the iteration
loop.

* Thru - The ending value of the iteration
loop.  When the value of the iterator is
greater than or equal to the Thru value, the
loop is completed.

* Step - The increment value between the
current value of the iterator and its next
value.
All open view parameters are available from
data inputs.

NOTES
The For Range output value is a Real scalar
ranging from the From to the Thru value.
Execution of the subthread hosted by the For
Range output continues until one of the
following occurs:

* All objects that can, have operated.  The
subthread is deactivated, the iteration
counter is incremented by the step value,
and, if the count value is less than the Thru
value, the subthread is reactivated by
refiring the For Range output with the new
iteration value.

* A Break object operated.  The subthread is
deactivated and the sequence output pin is
activated.  Note that the value that remains
on the For Range output is the same value
present when the Break was encountered.

* A Next object operated.  The subthread is
deactivated and the iteration counter is
incremented by the Step value.  If the count
value is less than the specified Thru, the
subthread is reactivated by refiring the Data
output with the new iteration value, and
execution of the subthread proceeds as usual.
If the iteration counter has reached the Thru
value, the sequence output pin is activated.

When you add any of the optional data
inputs, they do not necessarily line up with
the names of the fields to which they supply
a value.  Make sure you know which values you
are inputting and the pins associated with
them.  (Use Show Terminals if necessary.)

If the Thru value is less than the From
value, Step must be negative, otherwise the
output is never activated.

If Step = 0, the loop iterates infinitely
or until a Break object is encountered on the
subthread.

If From equals Thru, the loop executes
once.

When the subthread hosted by the For Range
object finishes an iteration, all data
containers sent during the previous iteration
are invalidated before the next iteration.
This prevents "old" data from a previous
iteration from being reused in the current
iteration.  However, if flow branching is
present within the iterative subthread, some
objects may not execute on every iteration.
Thus, data containers sent by those objects
may be invalidated before other objects can
execute on the data.  To obtain the desired
propagation in this case, use the Sample &
Hold object.  Refer to "Iteration with Flow
Branching" in chapter 4 of Using HP VEE for 
more information.

SEE ALSO
Break, For Count, For Log Range, Next, On
Cycle, Sample & Hold, Show Terminals, and
Until Break.
