# Ds\Map::diff

(PECL ds >= 1.0.0)

Ds\Map::diff — Créer une nouvelle map en utilisant des clés qui ne sont pas dans une autre map

### Description

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

Renvoie le résultat de la suppression de toutes les clés de l'instance actuelle qui sont présentes dans une `map` donnée.

`A \ B = {x ∈ A | x ∉ B}`

### Liste de paramètres

`map`

  La map contenant les clés à exclure de la map résultante.

### Valeurs de retour

Le résultat de la suppression de toutes les clés de l'instance actuelle qui sont présentes dans une `map` donnée.

### Voir aussi

- » Complement sur Wikipedia

### Exemples

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

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

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

    object(Ds\Map)#3 (1) {
      [0]=>
      object(Ds\Pair)#4 (2) {
        ["key"]=>
        string(1) "a"
        ["value"]=>
        int(1)
      }
    }