Devuelve el resultado de la adición de todas las asociaciones dadas

# Ds\Map::merge

(PECL ds >= 1.0.0)

Ds\Map::merge — Devuelve el resultado de la adición de todas las asociaciones dadas

### Descripción

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

Devuelve el resultado de la adición de todas las asociaciones de un objeto traversable dado o de un array con sus valores correspondientes, combinados con la instancia actual.

> Nota:

> Los valores de la instancia actual serán sobrescritos por los proporcionados cuando las claves sean iguales.

### Parámetros

`values`

  Un objeto traversable o un array.

### Valores devueltos

El resultado de la asociación de todas las claves de un objeto traversable dado o de un array con sus valores correspondientes, combinados con la instancia actual.

> Nota:

> La instancia actual no será afectada.

### Ejemplos

Ejemplo #1 Ejemplo de Ds\Map::merge()

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

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

Resultado del ejemplo anterior es similar 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
            )

    )

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