.foreach_item Macro

This macro is used for iterating on object collections:

.foreach_item (collection [,head [,tail [,condition [,comparison]]]])
	complex-template
.next [(separator)]

The template specified inside the block is applied to all objects contained in the specified collection.

If a comparison is specified, items in the collection are pre-sorted according to the corresponding rule before being iterated upon.

The following parameters are available:

Parameter

Description

collection

Collection over which iteration is performed

Type: Simple template

head

[optional] Generated before output, if there is one

Type: Text

tail

[optional] Appended to the output, if there is one

Type: Text

condition

[optional] If specified, only objects satisfying the given condition are considered during the iteration

Type: Simple condition

comparison

[optional] evaluated in a scope where two local objects respectively named 'Item1' and 'Item2' are defined. These correspond to items in the collection. <comparison> should evaluate to true if Item1 is to be placed after Item2 in the iteration

Type: Simple condition

complex-template

Template to apply to each item.

Type: Complex template

separator

[optional] Generated between non empty evaluations of <complex-template>

Type: Text

Note:

Macro parameters may be delimited by double quotes. The delimiters are required whenever the parameter value includes commas, braces, leading or trailing blanks. The escape sequence for double quotes inside a parameter value is \".

Example:

Attribute

Data type

Initial value

cust_name

String

__

cust_foreign

Boolean

false

.foreach_item(Attributes,,,,%Item1.Code% >= %Item2.Code%))
	Attribute %Code%[ = %InitialValue%];
.next(\n)

The result is:

Attribute cust_foreign = false

Attribute cust_name;

Note

The four commas after (Attributes,,,, means that all parameters (head, tail, condition and comparison) are skipped.