Elementname: Until

Description

Create a loop. All child elements are executed repeatedly until the given condition is true.

Allowed attributes: test

Child elements: Action, Attribute, Barcode, Column, Columns, Copy-of, DefineColor, DefineFontfamily, Element, EmptyLine, Fontface, ForAll, Group, HSpace, Hyphenation, Image, InsertPages, Li, LoadDataset, LoadFontfile, Loop, Message, NewPage, NextFrame, NextRow, Output, Paragraph, PlaceObject, ProcessNode, SaveDataset, SavePages, SetVariable, SortSequence, Sub, Sup, Switch, Tablehead, Tablerule, Td, Tr, Until, Value, While

Parent elements: AtPageCreation, AtPageShipout, Case, Contents, ForAll, Loop, Otherwise, Record, SavePages, Until, While

Attributes

test (XPath expression)

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"
Message: "$i is: 1"
Message: "$i is: 2"
Message: "$i is: 3"

See also

Switch, SetVariable, While

Commands

Version: 2.0.0 | Start page | Command reference | Other languages: German