CKTIS / Java
Set.contains — sprawdzanie, czy zbiór zawiera element
Sprawdź, czy zbiór zawiera element równy podanemu obiektowi, i dowiedz się, dlaczego można znaleźć nową instancję z tym samym identyfikatorem.
Wersja: Java SE 21
Składnia
boolean contains(Object o)
boolean present = set.contains(candidate);Set.contains to metoda instancji interfejsu java.util.Set<E>. Wywołanie set.contains(candidate) zwraca true, jeśli w zbiorze jest element e, dla którego Objects.equals(candidate, e) daje true, a w przeciwnym razie zwraca false. Metoda nie dodaje elementu ani go nie zwraca. Liczy się równość, a nie tożsamość referencji (==).
Parametr ma typ Object, a nie E, więc nawet w zbiorze Set<Member> można zapytać o obiekt innego typu. W zależności od implementacji zapytanie o niedozwolony typ może zwrócić false lub zgłosić ClassCastException, a zapytanie o null, gdy zbiór go nie dopuszcza, może zwrócić false lub zgłosić NullPointerException. HashSet dopuszcza null: contains(null) zwraca true tylko wtedy, gdy null znajduje się w zbiorze.
W HashSet wyszukiwanie korzysta z hashCode i equals. Równe obiekty muszą mieć ten sam kod skrótu, ale taki sam kod skrótu nie oznacza równości. Nie zmieniaj danych wpływających na equals, dopóki obiekt znajduje się w zbiorze: zachowanie zbioru po takiej zmianie nie jest określone.
W przykładzie rekordy mają domyślne equals i hashCode. Dwa obiekty Member z tym samym id są równe, nawet jeśli utworzono je osobno. Guest z tym samym id nie jest równy Member, bo to inna klasa rekordu.
Przykłady
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)));
}
}Wynik
true false false
Pierwszy wiersz to `true`: nowy `Member(100)` jest równy zapisanemu elementowi. `Member(101)` ma inny identyfikator, a `Guest(100)` należy do innej klasy, więc oba kolejne wyniki to `false`.
Powiązane lekcje
- Java · Lekcja 5 · Zaawansowany · Wersja: 2
- Java · Lekcja 42 · Podstawowy · Wersja: 2