Skip to main content

xSuite Interface Windows Prism 5.x – Online Help

Array

Arrays are lists of elements in fixed sequence. One-dimensional arrays are the only structured data type supported by the macro interpreter for handling multiple values.

The length of an array might vary arbitrarily at runtime. The data type of the elements it contains is also arbitrary. In practice, however, most functions that process arrays expect a concrete and uniform data type for all elements.

Indexed access to individual array elements via the index number of the elements is only possible with auxiliary functions (e.g., GetItem()) (see Array Operations). The element count always starts at 1.

The syntax for defining an array in a macro expression is [Element1, ..., ElementN],. The beginning and the end of the array are marked by square brackets. The individual elements are separated by commas.

If the content of an array not only serves to calculate intermediate values in a macro expression, but is also to be persisted as a field content of the document, the entire array with all its elements will represent the value of a single field. With regard to sending the data to an output format or system, it is best to only use formats and systems that can handle a data structure such as this.