Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti