Changes

This [[Module Library|XQuery Module]] contains functions for manipulating maps, which has . Maps have been introduced with [[XQuery 3.1and are described in detail in the [https://www.w3.org/TR/xpath-functions-31/#Maps|maps-and-arrays XQuery Functions and Operators 3.1]specification].

* <code>map:find(map { 1:2 }, 1)</code> returns <code>[ 2]</code>.* <code>map:find(map { 1: map { 2: map { 3: 4 } } }, 3)</code> returns <code>[ 4]</code>.* <code>map:find((1, 'b', true#0), 1)</code> returns an empty array.

|{{Func|map:for-each|$map as map(*), $fun function as function(xs:anyAtomicType, item()*) as item()*|item()*}}

|Applies a the specified {{Code|$function }} to every entry key/value pair of the supplied {{Code|$map}} and returns the results as a sequence. The function supplied as {{Code|$fun}} takes two arguments. It is called supplying the key of the map entry as the first argument, and the associated value as the second argument.

function($akey, $bvalue) { $a key + $b value }

# The {{Code|$options}} argument defines how duplicate keys are handled. Currently, a single option {{Code|duplicates}} exists, and its allowed values are {{Code|use-first}}, {{Code|use-last}}, {{Code|use-combine}} and {{Code|reject}}(default: {{Code|use-first}}).

| Creates a new ''map'', containing the entries of the supplied {{Code|$map}} and a new entry composed by {{Code|$key}} and {{Code|$value}}. The semantics of this function are equivalent to <code>map:merge(($map, map { $key, $value }, $map))</code>

* Added: <code>[[#map:find|map:find]]* Updated: [[#map:merge|map:merge]]: Signature extended with options argument. By default, value of first key is now adopted (instead of last, as in previous versions).

* Added: <code>[[#map:for-each|map:for-each]]</code>, <code>[[#map:merge|map:merge]]</code>, <code>[[#map:put|map:put]]</code>