# Ds\Map::merge

(PECL ds >= 1.0.0)

Ds\Map::merge — Renvoie le résultat de l'ajout de toutes les associations données

### Description

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

Renvoie le résultat de l'ajout de toutes les associations d'un objet traversable donné ou d'un tableau avec leurs valeurs correspondantes, combinées avec l'instance actuelle.

> Note:

> Les valeurs de l'instance actuelle seront écrasées par celles fournies lorsque les clés sont égales.

### Liste de paramètres

`values`

  Un objet traversable ou un tableau.

### Valeurs de retour

Le résultat de l'association de toutes les clés d'un objet traversable donné ou d'un tableau avec leurs valeurs correspondantes, combinées avec l'instance actuelle.

> Note:

> L'instance actuelle ne sera pas affectée.

### Exemples

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

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

Résultat de l'exemple ci-dessus est similaire à :

    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
            )

    )