Returns the result of adding all given associations

# Ds\Map::merge

(PECL ds >= 1.0.0)

Ds\Map::merge — Returns the result of adding all given associations

### 説明

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

Returns the result of associating all keys of a given traversable object or array with their corresponding values, combined with the current instance.

> 注意:

> Values of the current instance will be overwritten by those provided where keys are equal.

### パラメータ

`values`

  A traversable object or an array.

### 返り値

The result of associating all keys of a given traversable object or array with their corresponding values, combined with the current instance.

> 注意:

> The current instance won't be affected.

### 例

例1 Ds\Map::merge() example

`<?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
            )

    )