docs.roxen.comView this page in a printer friendly mode
DocsRoxenWebServer 6.1Web Developer ManualEmit Tags
Copyright  2018, Roxen Internet Software
Suggestions, comments & compliments
manuals@roxen.com
 DEMO  DOCS  PIKE
 COMMUNITY  DOWNLOAD
www.roxen.com



<emit>
<emit atlas>
<emit captcha>
<emit cimg>
<emit dir>
<emit exec>
<emit fonts>
<emit imgs>
<emit js-dynamic-popup>
<emit js-hide-popup>
<emit languages>
<emit ldap>
<emit path>
<emit scopes>
<emit sources>
<emit spellcheck>
<emit sql>
<emit timerange>
<emit values>
<emit ws-dir>
<emit xml-db>

<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 multiple fields by using this attribute:

lines

The input is split on individual line-feed and carriage-return characters and in combination. Note that the separator characters are not kept in the output values.

words

The input is split on the common white-space characters (line-feed, carriage-return, space and tab). White-space is not retained in the fields. Note that if a field ends with one of the punctuation marks '.', ',', ':', ';', '!' or '?', the punctuation mark will be removed.

chars

(Characters) The input is split into individual characters.

csv

(Comma-separated values) This input is first split into lines, and the lines then split into fields on ',' and ';' according to CSV quoting rules. Note that this results in a two-dimensional result.


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.