# Ds\Map::union

(PECL ds >= 1.0.0)

Ds\Map::union — Créer une nouvelle carte en utilisant les valeurs de l'instance actuelle et d'une autre carte

### Description

public Ds\Map::union(Ds\Map `$map`): Ds\Map

Créer une nouvelle carte qui contient les paires de l'instance actuelle ainsi que les paires d'une autre `map`.

`A ∪ B = {x: x ∈ A ∨ x ∈ B}`

> Note:

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

### Liste de paramètres

`map`

  L'autre carte, à combiner avec l'instance actuelle.

### Valeurs de retour

Une nouvelle carte contenant toutes les paires de l'instance actuelle ainsi que d'une autre `map`.

### Voir aussi

- » >Union sur Wikipedia

### Exemples

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

`<?php
$a = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
$b = new \Ds\Map(["b" => 3, "c" => 4, "d" => 5]);
print_r($a->union($b));
?>`

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

    Ds\Map Object
    (
        [0] => Ds\Pair Object
            (
                [key] => a
                [value] => 1
            )

        [1] => Ds\Pair Object
            (
                [key] => b
                [value] => 3
            )

        [2] => Ds\Pair Object
            (
                [key] => c
                [value] => 4
            )

        [3] => Ds\Pair Object
            (
                [key] => d
                [value] => 5
            )

    )