NAME
cxLoopBreak
- Force loop controller to terminate loop.
C SPECIFICATION
#include <cx/Info.h>
void cxLoopBreak()
FORTRAN SPECIFICATION
subroutine cxLoopBreak
DESCRIPTION
Normally, a loop will continue execution
(refire the loop controller after the loop has executed)
if any new data is sent out to modules in the loop from the controller.
cxLoopBreak
forces termination of the loop, regardless of whether the loop
controller sends new data to the loop modules.
It is usually necessary to terminate the loop explicitly with
cxLoopBreak.
For example, the
For
module updates its "Current Value" widget on each iteration.
If "Current Value" is wired into the loop, those modules that
receive it will attempt to fire again.
However, if those modules also have inputs from the "Loop Value"
ports, no data will arrive in those input ports from the loop
controller, by virtue of cxLoopBreak being called, and the
loop modules will not fire again.
SEE ALSO
cxLoopCtlr(3E),
cxLoopIteration(3E),
cxLoopControlArc(3E)
Last modified: Mon Nov 18 13:50:47 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996