CKTIS / Java
Set.contains — verificar se um conjunto contém um elemento
Verifica se um conjunto contém um elemento igual ao objeto indicado e percebe por que razão uma nova instância com o mesmo identificador pode ser encontrada.
Versão: Java SE 21
Sintaxe
boolean contains(Object o)
boolean present = set.contains(candidate);Set.contains é um método de instância da interface java.util.Set<E>. A chamada set.contains(candidate) devolve true se existir um elemento guardado e para o qual Objects.equals(candidate, e) seja true, e false se não houver correspondência. O método não adiciona nem devolve um elemento. O que conta é a igualdade, não a identidade das referências (==).
O parâmetro é do tipo Object, não E, pelo que é possível consultar um Set<Member> com um objeto de outro tipo. Dependendo da implementação, uma consulta com um tipo incompatível pode devolver false ou lançar ClassCastException. Se o conjunto não aceitar null, uma consulta com null pode devolver false ou lançar NullPointerException. HashSet aceita null: contains(null) só devolve true se null estiver guardado.
HashSet usa hashCode e equals para procurar. Objetos iguais têm de ter o mesmo código hash, mas partilhar um código hash não implica igualdade. Não alteres dados que afetem equals enquanto o objeto estiver no conjunto: o comportamento do conjunto após essa alteração não está especificado.
Os records do exemplo usam as implementações predefinidas de equals e hashCode. Dois objetos Member com o mesmo id são iguais, mesmo que tenham sido criados separadamente. Um Guest com o mesmo id não é igual a um Member, porque pertence a outra classe de record.
Exemplos
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)));
}
}Resultado
true false false
A primeira linha é `true`: o novo `Member(100)` é igual ao elemento guardado. `Member(101)` tem um identificador diferente e `Guest(100)` pertence a outra classe, pelo que as duas linhas restantes são `false`.
Lições relacionadas
- Java · Lição 5 · Avançado · Versão: 2
- Java · Lição 42 · Básico · Versão: 2