Php/docs/ds-map.merge

• PHP Manual
• Map
• 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
        )

)