Documentación offline PHP master

Ds\Map::merge

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Ds\Map::merge

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

Descripción#

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

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.

> [!NOTE]
> 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.

> [!NOTE]
> La instancia actual no será afectada.

## Ejemplos

Ejemplo de `Ds\Map::merge`
1, "b" => 2, "c" => 3]); print_r($map->merge(["a" => 10, "e" => 50])); ?>

```php

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
        )

)