Iterates over the component values of a string or a compound
value. If it's a string, it's splitted into pieces using a
separator string, and the plugin then iterates over the pieces. If
it's a compound value like an array then the plugin iterates over its
elements.
- values="mixed"
-
The value to iterate over. This attribute is required unless the
"variable" or "from-scope" attribute is used.
- variable="name"
-
Name of a variable from which the value are taken.
- split="string" (NULL)
-
The string to split a string value with. Supplying an empty string
results in the string being split between every single character.
This has no effect if the value isn't a string.
- nosplit
-
If specified then the value isn't split, even when it is a string.
Instead the plugin only evaluates its contents once using the whole
string.
This is useful if a value might either be a single string or
multiple strings as an array, and you want to iterate over each full
string.
- advanced="{lines, words, chars}"
-
If the value is a string it can be splitted into separate lines,
words or characters by using this attribute.
- case="{upper, lower}"
-
Change the case of each returned value.
- trimwhites
-
Trim away all leading and trailing white space charachters from each
returned value.
- randomize="{yes, no}"
-
Outputs the values in random order.
- distinct
-
If specified, values are only output once even if they occur several times.
- from-scope="name"
-
Iterate over a scope like a mapping. &_.index; gets the
name of each variable in it and &_.value; gets the
corresponding value.