Maps and arrays Functions

Last updated 8 months ago
Introduction
XPath 3.1 introduces maps and arrays. Orbeon Forms does not support XPath 3.1 yet, however it implements a subset of operations on maps and arrays.
Availability
[SINCE Orbeon Forms 2017.2]
Maps
Introduction
Orbeon Forms does not support the native XPath 3.1 syntax to create maps. But you can create a new map as follows using the map:merge() and map:entry() functions:
map:merge(
    (
        map:entry('number',   42),
        map:entry('string',   'forty-two'),
        map:entry('node',     instance()),
        map:entry('sequence', 1 to 10)
    )
)
map:entry()
map:entry(
    $key as xs:anyAtomicType,
    $value as item()*
) as map(*)
​XPath 3.1 documentation.
map:merge()
map:merge($maps as map(*)*) as map(*)
​XPath 3.1 documentation.
map:get()
map:get(
    $map as map(*),
    $key as xs:anyAtomicType
) as item()*
​XPath 3.1 documentation.
Arrays
Introduction
Orbeon Forms does not support the native XPath 3.1 syntax to create arrays. But you can create a new array as follows using the array:join() and array:append() functions:
array:append(
    array:append(
        array:append(
            array:append(
                array:join(()),
                42
            ),
            'forty-two'
        ),
        instance()
    ),
    1 to 10
)
array:size()
array:size($array as array(*)) as xs:integer
​XPath 3.1 documentation.
array:get()
array:get($array as array(*), $position as xs:integer) as item()*
​XPath 3.1 documentation.
array:put()
array:put(
    $array    as array(*),
    $position as xs:integer,
    $member   as item()*
) as array(*)
​XPath 3.1 documentation.
array:append()
array:append(
    $array     as array(*),
    $appendage as item()*
) as array(*)
​XPath 3.1 documentation.
array:join()
array:join($arrays as array(*)*) as array(*)
​XPath 3.1 documentation.
Standard functions
Extension functions