IBM Visualization Data Explorer User's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

Done

Category

Flow Control

Function

Specifies whether a loop is to be terminated.

Syntax Done(done);

Inputs
Name Type Default Description
done flag none 0: no termination
1: terminate the loop

Functional Details

This module terminates a loop. If done is set to:

0

The macro containing the Done module will continue to execute until
done = 1 or until one of the other looping tools (ForEachN or ForEachMember) terminates the loop.

1

The loop is terminated upon completion of the current loop iteration, regardless of how many iterations have been, or remain to be, executed.

Typically, loops are initiated with ForEachMember or ForEachN, although they can also be implemented with a Get/Set pair and Done.

Notes:

  1. If this module is used in the scripting language, the results are defined only if it is used inside a macro.

  2. If done is set to 1 by an interactor during the execution of a loop, the new setting will not take effect until the loop is completed: new interactor values are considered at the end of an execution, and a complete loop is considered to be a single execution.

  3. Simply placing a Done icon in a visual program and setting the parameter done to 0 (zero) will create an infinite loop.

Example Visual Programs

Bounce.net
SimpleGetSetLoop.net

See Also

 First,  ForEachMember,  ForEachN,  GetGlobal,  GetLocal,  SetGlobal,  SetLocal

 Chapter 4. "Data Explorer Execution Model" in IBM Visualization Data Explorer User's Guide.


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]