Создаёт новую коллекцию пар из элементов двух коллекций

# Ds\Map::union

(PECL ds >= 1.0.0)

Ds\Map::union — Создаёт новую коллекцию пар из элементов двух коллекций

### Описание

public function Ds\Map::union(Ds\Map `$map`): Ds\Map

Создаёт новую коллекцию пар, содержащую пары текущей и переданной в `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
            )

    )

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open