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