Ds\Map::merge

(PECL ds >= 1.0.0)

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

Описание

public 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
        )

)