Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła