Array Inspection
array:length — Get array length
Returns the number of items in an array.
Syntax
XML
<array:length var="arrayName" var_result="resultVar" />
Example
XML
<output>Count: <array:length var="names" /></output>
array:keyexists — Check if key exists
Checks whether a specific key exists within an array.
Syntax
XML
<array:keyexists var="arrayName" var_result="resultVar">keyToCheck</array:keyexists>
Example
XML
<array:keyexists var="names" var_result="exists">sj</array:keyexists>
array:valueexists — Check if value exists
Checks whether a specific value exists within an array.
Syntax
XML
<array:valueexists var="arrayName" var_result="resultVar">valueToFind</array:valueexists>
array:pos — Find position of value
Searches an array for a value and returns the key of the matching item.
Syntax
XML
<array:pos var="arrayName" var_result="resultVar">valueToFind</array:pos>
Attributes
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
var | var | Yes | — | The array to search. |
type | type | No | first | first or last. |
offset | int | No | — | Items to skip. |
array:first — Get first item
Returns the first item of an array (key and value).
Syntax
XML
<array:first var="arrayName" var_key="keyVar" var_value="valueVar" />
array:last — Get last item
Returns the last item of an array.
Syntax
XML
<array:last var="arrayName" var_key="keyVar" var_value="valueVar" />
array:rand — Get random item
Returns a randomly selected item.
Syntax
XML
<array:rand var="arrayName" var_key="keyVar" var_value="valueVar" />