Set.prototype.isDisjointFrom()

Syntax

isDisjointFrom(other)

Parameter

other

Ein Set-Objekt oder ein Set-ähnliches Objekt.

Rückgabewert

true, wenn diese Menge keine gemeinsamen Elemente mit der Menge other hat, andernfalls false.

Beschreibung

Zwei Mengen sind disjunkt, wenn sie keine gemeinsamen Elemente haben. In mathematischer Schreibweise:

Als Venn-Diagramm:

isDisjointFrom() akzeptiert Set-ähnliche Objekte als Parameter other. this muss eine tatsächliche Set-Instanz sein, da die Methode direkt auf die in this gespeicherten Daten zugreift, ohne benutzerdefinierten Code aufzurufen. Das weitere Verhalten hängt von der Größe von this und other ab:

• Wenn this mehr Elemente enthält als durch other.size angegeben, durchläuft die Methode other, indem sie dessen Methode keys() aufruft. Ist ein Element von other in this enthalten, gibt sie false zurück (und schließt den keys()-Iterator durch Aufruf seiner Methode return()). Andernfalls gibt sie true zurück.
• Andernfalls durchläuft sie die Elemente von this und gibt false zurück, wenn für ein Element e aus this der Aufruf other.has(e) einen truthy Wert zurückgibt. Andernfalls gibt sie true zurück.

Aufgrund dieser Implementierung hängt die Effizienz von isDisjointFrom() hauptsächlich von der Größe der kleineren der beiden Mengen this und other ab (vorausgesetzt, der Zugriff auf Mengen ist in sublinearer Zeit möglich).

Beispiele

isDisjointFrom() verwenden

Die Menge der Quadratzahlen (<20) ist disjunkt zur Menge der Primzahlen (<20), da sich eine Quadratzahl definitionsgemäß als Produkt zweier ganzer Zahlen darstellen lässt und 1 ebenfalls nicht als Primzahl gilt:

const primes = new Set([2, 3, 5, 7, 11, 13, 17, 19]);
const squares = new Set([1, 4, 9, 16]);
console.log(primes.isDisjointFrom(squares)); // true

Die Menge der Quadratzahlen (<20) ist nicht disjunkt zur Menge der zusammengesetzten Zahlen (<20), da alle Quadratzahlen außer 1 definitionsgemäß zusammengesetzte Zahlen sind:

const composites = new Set([4, 6, 8, 9, 10, 12, 14, 15, 16, 18]);
const squares = new Set([1, 4, 9, 16]);
console.log(composites.isDisjointFrom(squares)); // false

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für Set.prototype.isDisjointFrom in core-js
• es-shims-Polyfill für Set.prototype.isDisjointFrom
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()