Set.prototype.difference()

Метод difference() (різниця) примірників Set приймає іншу множину та повертає нову множину, що вміщає елементи поточної множини, не присутні в переданій множині.

Синтаксис

difference(other)

Параметри

other

Об'єкт Set, або множиноподібний об'єкт.

Повернене значення

Новий об'єкт Set, що вміщає елементи поточної множини, не присутні в множині other.

Опис

У математичний спосіб difference визначається так:

$$A\setminus B = {x\in A\mid x\notin B}$$

І – з використанням діаграми Венна:

Метод difference() приймає множиноподібні об'єкти як параметр other. Він вимагає, щоб this був справжнім екземпляром Set, оскільки він безпосередньо отримує дані, збережені в this, без виклику будь-якого користувацького коду. Потім його поведінка залежить від розмірів this та other:

• Якщо число елементів у this перевищує other.size, то він ітерує по other, викликаючи її метод keys(), і конструює нову множину з елементів this, не помічених в other.
• Інакше – він ітерує по елементах this і конструює нову множину з усіх елементів e в this, які змушують other.has(e) повернути хибне значення.

Порядок елементів у поверненій множині – такий же, як у this.

Приклади

Застосування difference()

Наступний приклад обчислює різницю між множиною непарних чисел (<10) та множиною цілих квадратів (<10). Результат – множина непарних чисел, які не є цілими квадратами.

const odds = new Set([1, 3, 5, 7, 9]);
const squares = new Set([1, 4, 9]);
console.log(odds.difference(squares)); // Set(3) { 3, 5, 7 }

Специфікації

Сумісність із браузерами

Дивіться також

• Поліфіл Set.prototype.difference у складі core-js
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()