Iterators

Table of Contents

• Table of Contents
• The ITERATOR node

The ITERATOR node

The ITERATOR node is used to cause its parent node and all its children to be repeated for each value in the list defined by the iterator. The syntax of an iterator node is as follows:

PARAMETER
{
    type = ReachState

    ITERATOR
    {
        type = CelestialBody
        targetBody = AllBodies().Where(cb => cb.IsPlanet())
    }
}

The above is equivalent to manually writing out:

PARAMETER
{
    type = ReachState
    targetBody = Moho
}
PARAMETER
{
    type = ReachState
    targetBody = Eve
}
...

The main advantage of an iterator node is flexibility when dealing with dynamic data. For example, the manual approach above would not support planets added by other add-ons. It is also useful when the number of PARAMETER nodes required is unknown (example, a parameter for each of a planet's moons).

Iterator nodes may exist within PARAMETER nodes.

Within the ITERATOR node, the following fields can be specified:

Field	Description
type	The data type for elements within the ITERATOR node. Supports any data type listed on the [[Expressions
<identifier>	An identifier that contains the expression. The expression itself should be a List<> of the type specified by type. It can be an identifier that is defined by the parent node (as with the example above) or any arbitrary identifier.

Identifiers created in a ITERATOR node are accessed as if they were a part of the parent node (by referencing them as @<identifier> within that node).