Ds\Map::merge

(PECL ds >= 1.0.0)

Ds\Map::merge — Retorna o resultado da adição de todas as associações fornecidas

Descrição

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

Retorna o resultado da associação de todas as chaves de um objeto traversable ou array fornecido com seus valores correspondentes, combinados com a instância atual.

Note:

Os valores da instância atual serão sobrescritos pelos fornecidos quando as chaves forem iguais.

Parâmetros

values

Um objeto traversable ou um array.

Valor Retornado

O resultado da associação de todas as chaves de um objeto traversable ou array fornecido com seus valores correspondentes, combinados com a instância atual.

Note:

A instância atual não será afetada.

Exemplos

Example #1 Ds\Map::merge() exemplo

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

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

O exemplo acima produzirá algo semelhante a:

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
        )

)