(PECL ds >= 1.0.0)
Ds\Map::union — Создаёт новую коллекцию пар из элементов двух коллекций
   Создаёт новую коллекцию пар, содержащую пары текущей и переданной в
   map коллекций.
  
   A ∪ B = {x: x ∈ A ∨ x ∈ B}
  
Замечание:
В случае совпадения ключей, значения элементов будут браться из переданной коллекции.
mapНовая коллекция, для объединения с текущей.
   Новая коллекция пар, являющийся объединением текущей и переданной в
   map.
  
Пример #1 Пример использования Ds\Map::union()
<?php
$a = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
$b = new \Ds\Map(["b" => 3, "c" => 4, "d" => 5]);
print_r($a->union($b));
?>Вывод приведённого примера будет похож на:
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => a
            [value] => 1
        )
    [1] => Ds\Pair Object
        (
            [key] => b
            [value] => 3
        )
    [2] => Ds\Pair Object
        (
            [key] => c
            [value] => 4
        )
    [3] => Ds\Pair Object
        (
            [key] => d
            [value] => 5
        )
)
