Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Set.contains — verificare se un insieme contiene un elemento

Verifica se un insieme contiene un elemento uguale all’oggetto passato e scopri perché anche una nuova istanza con lo stesso identificatore può essere trovata.

Versione: Java SE 21

Sintassi

boolean contains(Object o)
boolean present = set.contains(candidate);

Set.contains è un metodo di istanza dell’interfaccia java.util.Set<E>. La chiamata set.contains(candidate) restituisce true se esiste un elemento memorizzato e per cui Objects.equals(candidate, e) vale true, altrimenti restituisce false. Il metodo non aggiunge né restituisce alcun elemento. Verifica l’uguaglianza, non l’identità dei riferimenti (==).

Il parametro è di tipo Object, non E: si può quindi interrogare anche un Set<Member> con un oggetto di un altro tipo. A seconda dell’implementazione, una ricerca con un tipo incompatibile può restituire false o lanciare ClassCastException. Se l’insieme non ammette null, una ricerca con null può restituire false o lanciare NullPointerException. HashSet ammette null: contains(null) restituisce true solo se null è presente.

HashSet usa hashCode ed equals per la ricerca. Oggetti uguali devono avere lo stesso codice hash, ma avere lo stesso codice hash non implica uguaglianza. Non modificare i dati da cui dipende equals mentre l’oggetto è nell’insieme: il comportamento dell’insieme dopo una tale modifica non è specificato.

I record dell’esempio usano le implementazioni predefinite di equals e hashCode. Due oggetti Member con lo stesso id sono uguali anche se sono stati creati separatamente. Un Guest con lo stesso id non è uguale a un Member perché appartiene a un’altra classe record.

Esempi

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)));
    }
}

Risultato

true
false
false

La prima riga è `true`: il nuovo `Member(100)` è uguale all’elemento memorizzato. `Member(101)` ha un identificatore diverso e `Guest(100)` appartiene a un’altra classe, quindi le altre due righe sono `false`.

Lezioni correlate

  • Java · Lezione 5 · Avanzato · Versione: 2
  • Java · Lezione 42 · Base · Versione: 2

Fonti