Возвращает результат добавления всех заданных элементов в коллекцию

# Ds\Map::merge

(PECL ds >= 1.0.0)

Ds\Map::merge — Возвращает результат добавления всех заданных элементов в коллекцию

### Описание

public function Ds\Map::merge(mixed `$values`): Ds\Map

Возвращает результат добавления всех ключей переданного объекта класса traversable или массива (array) с соответствующими значениями в текущую коллекцию.

> Замечание:

> Значения текущей коллекции будут перезаписаны, если переданные ключи уже существуют.

### Список параметров

`values`

  Объект класса traversable или array.

### Возвращаемые значения

Возвращает результат добавления всех ключей переданного объекта класса traversable или массива с соответствующими значениями в текущую коллекцию

> Замечание:

> Текущий экземпляр коллекции останется нетронутым.

### Примеры

Пример #1 Пример использования Ds\Map::merge()

    <?php
    $map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);

    print_r($map->merge(["a" => 10, "e" => 50]));
    ?>

Вывод приведённого примера будет похож на:

    Ds\Map Object
    (
        [0] => Ds\Pair Object
            (
                [key] => a
                [value] => 10
            )

        [1] => Ds\Pair Object
            (
                [key] => b
                [value] => 2
            )

        [2] => Ds\Pair Object
            (
                [key] => c
                [value] => 3
            )

        [3] => Ds\Pair Object
            (
                [key] => e
                [value] => 50
            )

    )

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