PHP Manual
Коллекция пар ключ-значение
Создает новую коллекцию пар с элементами, ключей которых нет в другой коллекции пар

Ds\Map::diff

(PECL ds >= 1.0.0)

Ds\Map::diff — Создает новую коллекцию пар с элементами, ключей которых нет в другой коллекции пар

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

Возвращает новую коллекцию пар, не содержащую элементов с ключами, которые присутствуют в коллекции пар, переданной в map.

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

map: Коллекция пар, содержащая элементы с ключами, которых не должно быть в новой коллекции пар.

Результат удаления всех элементов, ключи которых присутствуют в коллекции пар, переданной в map.

Пример #1 Пример использования 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));
?>

Результатом выполнения данного примера будет что-то подобное:

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