Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

HashSet.add(E) — dodawanie elementu do zbioru

Metoda `HashSet.add(E)` zwraca `true`, gdy doda nowy element, albo `false`, gdy zbiór zawiera już równy element.

Wersja: Java SE 21

Składnia

public boolean add(E e)

W Java SE 21 HashSet.add(E) to metoda instancji klasy java.util.HashSet<E>. Przyjmuje jeden element e typu E, określonego przy deklaracji zbioru, na przykład String w HashSet<String>.

Jeśli w zbiorze nie ma elementu e2, dla którego Objects.equals(e, e2) zwraca true, metoda dodaje e, zwiększa rozmiar zbioru o jeden i zwraca true. W przeciwnym razie zwraca false i nie zmienia zbioru: nie zastępuje istniejącego elementu. HashSet dopuszcza null, więc pierwsze dodanie null zwraca true, a następne zwraca false, dopóki null należy do zbioru.

W klasach własnych zadbaj o zgodność equals i hashCode: równe obiekty muszą mieć ten sam kod skrótu, ale identyczny kod skrótu nie oznacza równości. Nie zmieniaj danych używanych przez te metody, dopóki obiekt znajduje się w zbiorze. HashSet nie gwarantuje kolejności iteracji, w tym kolejności wstawiania.

Użyj if (tags.add(tag)), aby wykonać kod tylko wtedy, gdy element został dodany, bez wcześniejszego wywołania contains. Nie każdy Set działa tak samo: zbiór utworzony przez Set.of(...) jest niemodyfikowalny, a jego metoda add zgłasza UnsupportedOperationException.

Przykłady

import java.util.HashSet;

public class Main {
    public static void main(String[] args) {
        HashSet<String> tags = new HashSet<>();

        System.out.println(tags.add("java"));
        System.out.println(tags.add(new String("java")));
        System.out.println(tags.add(null));
        System.out.println(tags.add(null));
        System.out.println(tags.size());
    }
}

Wynik

true
false
true
false
2

`new String("java")` celowo tworzy inny obiekt o tej samej treści. Drugie wywołanie zwraca więc `false` z powodu równości napisów, a nie dlatego, że to ten sam obiekt. Na końcu zbiór zawiera dwa elementy: `"java"` i `null`.

Powiązane lekcje

  • Java · Lekcja 55 · Podstawowy · Wersja: 2

Źródła