WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Set.contains — prüfen, ob eine Menge ein Element enthält

Prüfe, ob eine Menge ein Element enthält, das dem übergebenen Objekt gleicht, und erfahre, warum auch eine neue Instanz mit derselben ID gefunden werden kann.

Version: Java SE 21

Syntax

boolean contains(Object o)
boolean present = set.contains(candidate);

Set.contains ist eine Instanzmethode der Schnittstelle java.util.Set<E>. Der Aufruf set.contains(candidate) liefert true, wenn es ein gespeichertes Element e gibt, für das Objects.equals(candidate, e) den Wert true ergibt, und andernfalls false. Die Methode fügt kein Element hinzu und gibt auch keines zurück. Entscheidend ist Gleichheit, nicht Referenzidentität (==).

Der Parameter hat den Typ Object, nicht E. Deshalb lässt sich auch ein Set<Member> mit einem Objekt eines anderen Typs abfragen. Je nach Implementierung kann ein inkompatibler Typ zu false oder einer ClassCastException führen. Bei einer Menge, die null nicht zulässt, kann die Abfrage mit null den Wert false liefern oder eine NullPointerException auslösen. HashSet erlaubt null: contains(null) liefert nur dann true, wenn null gespeichert ist.

HashSet verwendet bei der Suche hashCode und equals. Gleiche Objekte müssen denselben Hashcode haben; der gleiche Hashcode allein belegt aber keine Gleichheit. Ändere keine Daten, die equals beeinflussen, solange das Objekt in der Menge liegt: Nach einer solchen Änderung ist das Verhalten der Menge nicht spezifiziert.

Die Records im Beispiel verwenden die Standardimplementierungen von equals und hashCode. Zwei Member-Objekte mit derselben id sind gleich, auch wenn sie getrennt erzeugt wurden. Ein Guest mit derselben id ist einem Member nicht gleich, weil er zu einer anderen Record-Klasse gehört.

Beispiele

import java.util.HashSet;
import java.util.Set;

public class Main {
    record Member(int id) {}
    record Guest(int id) {}

    public static void main(String[] args) {
        Set<Member> members = new HashSet<>();
        members.add(new Member(100));

        System.out.println(members.contains(new Member(100)));
        System.out.println(members.contains(new Member(101)));
        System.out.println(members.contains(new Guest(100)));
    }
}

Ergebnis

true
false
false

Die erste Zeile lautet `true`: Der neue `Member(100)` ist dem gespeicherten Element gleich. `Member(101)` hat eine andere ID, und `Guest(100)` gehört zu einer anderen Klasse. Die beiden übrigen Zeilen lauten daher `false`.

Zugehörige Lektionen

  • Java · Lektion 5 · Fortgeschritten · Version: 2
  • Java · Lektion 42 · Grundlagen · Version: 2

Quellen