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