Until

Create a loop. All child elements are executed repeatedly until the given condition is true. The return value of Until is the concatenated return value of the child elements.

Child elements

ClearPage, Column, Li, LoadDataset, Loop, Message, NextFrame, NextRow, Paragraph, PlaceObject, ProcessNode, SaveDataset, SetVariable, Switch, Tr, Until, Value, While

Parent elements

AtPageCreation, AtPageShipout, Case, Contents, ForAll, Loop, Otherwise, Record, SetVariable, Until, While

Attributes

test (XPath expressions)

Every time after the the loop is executed, the condition is evaluated. If it is true, the loop exits.

Example

<Record element="data">
  <SetVariable variable="i" select="0"/>
  <Until test="$i = 4">
    <Message select="concat('$i is: ', $i)"/>
    <SetVariable variable="i" select="$i + 1"/>
  </Until>
</Record>

Gives the following output (in the protocol file)

Message: "$i is: 0.000000"
Message: "$i is: 1.000000"
Message: "$i is: 2.000000"
Message: "$i is: 3.000000"

See also

<Loop>, <While>, the section about programming.