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

USE
Use For Count to execute a subthread a
specified number of iterations.  The output
of a For Count can be used as a value for
succeeding objects in the subthread.

LOCATION
Flow ==> Repeat ==> For Count

OPEN VIEW PARAMETERS
Enter the number of iterations in the entry
field or as an input.  The value must be an
Real.

NOTES
The For Count output value is a Real scalar
ranging from 0 to n-1 where n is the
specified count value.  All access to
unmapped array objects is zero-based,
therefore For Count is ideally suited for
traversing the dimensions of such objects
when required.  The For Count value is the
dimension size.

If the specified For Count value is zero
or negative, the output is not activated, but
the sequence output pin is.

Execution of the subthread hosted by the
For Count output continues until one of the
following occurs:

* All objects that can, have operated.  The
subthread is deactivated, the iteration
counter is incremented, and, if the count
value is less than the specified count, the
subthread is reactivated by refiring the For
Count 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 Count 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.  If the count value is less than
the specified Count, the subthread is
reactivated by refiring the Count output with
the new iteration value, and execution of the
subthread proceeds as usual.  If the
iteration counter has reached the Count
value, the sequence output pin is activated.

When the subthread hosted by the For Count
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 Log Range, For Range, Get Values,
Next, On Cycle, Sample & Hold, Set Values,
and Until Break.
