docs.roxen.comBack to normal mode
DocsRoxenWebServer 5.0Web Developer ManualEmit Tags
Copyright © 2012, Roxen Internet Software
Suggestions, comments & compliments
manuals@roxen.com

<emit source="values"></emit>

Provided by module: Tags: RXML tags

Iterates over the component values of a string or a compound value. If it's a string, it's split 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.


Attributes

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, csv, chars}"

If the value is a string it can be split into separate lines, words, CSV (comma separated values) fields 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 if it has the value 'yes'.


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.


&_.index; (provided by Tags: RXML tags)

The index of one element. This is set if the value being iterated over is a mapping/scope or a multiset.


&_.value; (provided by Tags: RXML tags)

The value of one element or substring if a string is being split.