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



<append>
<copy-scope>
<dec>
<define>
<elements>
<inc>
<insert>
<insert cached-href>
<insert file>
<insert href>
<insert realfile>
<insert scopes>
<insert variable>
<insert variables>
<json-format>
<json-parse>
<range>
<recaptcha-site-key>
<roxen-automatic-charset-variable>
<scope>
<set>
<sprintf>
<sscanf>
<undefine>
<unset>
<use>
<value>
<vform>

<value></value>

Provided by module: Tags: RXML tags

Creates a single value from its contents or some other source. This is mainly useful to build the elements in array or mapping contexts. E.g:

<set variable="var.arr" type="array"> <value>apple</value> <value>orange</value> <value>banana</value> </set> &var.arr;
Array result: ({"apple", "orange", "banana"})

This tag takes a "type" attribute to set the type of its content, just like e.g. <set>. That can be useful e.g. to build arrays inside arrays:

<value type="array"> <value>1</value> <value type="array"> <value>1.1</value> <value>1.2</value> </value> <value>2</value> </value>
Array result: ({"1", ({"1.1", "1.2"}), "2"})

Note that a variable with an array value is normally spliced into an array context. Here too an extra <value> tag is useful to make it a nested array:

<set variable="var.x" split=",">a,b</set> <value type="array"> <!-- Insert all the elements in var.x --> &var.x; <!-- Compare to the following that adds the var.x array as a single element. --> <value>&var.x;</value> </value>
Array result: ({"a", "b", ({"a", "b"})})

Attributes

type="type"

The type of the content and the result (except if it's "array" - then the result is "any" to avoid splicing the array into the surrounding array, as shown above). Defaults to "any".


index

Used when the surrounding type is a mapping. This specifies the index for the value. E.g:

<value type="mapping"> <value index="1">first</value> <value index="2">second</value> <value index="3">third</value> </value>
Mapping result: (["1": "first", "2": "second", "3": "third"])

This attribute cannot be left out when a mapping is constructed, and it must not be given otherwise.


from="string"

Get the value from this variable. The content must be empty if this is used.


expr="string"

An expression that gets evaluated to produce the value. The content must be empty if this is used.