CKTIS / Java
HashSet.add(E): aggiungere un elemento a un insieme
`HashSet.add(E)` restituisce `true` se inserisce un nuovo elemento e `false` se l’insieme contiene già un elemento uguale.
Versione: Java SE 21
Sintassi
public boolean add(E e)In Java SE 21, HashSet.add(E) è un metodo di istanza di java.util.HashSet<E>. Accetta un solo elemento e del tipo E dell’insieme, per esempio String in HashSet<String>.
Se nell’insieme non c’è alcun elemento e2 per cui Objects.equals(e, e2) restituisce true, il metodo inserisce e, aumenta di uno la dimensione dell’insieme e restituisce true. Altrimenti restituisce false e lascia l’insieme invariato: non sostituisce l’elemento esistente. HashSet ammette null, quindi il primo inserimento di null restituisce true; quelli successivi restituiscono false finché null rimane nell’insieme.
Nelle tue classi, mantieni coerenti equals e hashCode: oggetti uguali devono avere lo stesso codice hash, ma lo stesso codice hash non implica che gli oggetti siano uguali. Non modificare i dati usati da questi metodi finché l’oggetto è nell’insieme. HashSet non garantisce alcun ordine di iterazione, nemmeno quello di inserimento.
Usa if (tags.add(tag)) per eseguire codice solo se l’elemento è stato inserito, senza chiamare prima contains. Non tutti i Set si comportano così: un insieme creato con Set.of(...) non è modificabile e chiamare add su di esso causa una UnsupportedOperationException.
Esempi
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());
}
}Risultato
true false true false 2
`new String("java")` crea intenzionalmente un oggetto diverso con lo stesso testo. La seconda chiamata restituisce `false` perché le stringhe sono uguali, non perché sono lo stesso oggetto. Alla fine l’insieme contiene due elementi: `"java"` e `null`.
Lezioni correlate
- Java · Lezione 55 · Base · Versione: 2