Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

HashSet.contains(Object) — verificar se um elemento está presente

`contains` verifica se um `HashSet` contém um elemento igual ao argumento. Devolve `true` ou `false` sem alterar o conjunto.

Versão: Java SE 21

Sintaxe

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

Em Java SE 21, HashSet.contains(Object), da classe java.util.HashSet, devolve true se o conjunto contiver um elemento e para o qual Objects.equals(o, e) é verdadeiro. Caso contrário, devolve false. O que conta é a igualdade, não o facto de ambas as referências apontarem para o mesmo objeto. O método não adiciona nem remove elementos.

O parâmetro o é do tipo Object, não E. Assim, podes procurar um Integer num HashSet<String>, embora não o possas inserir com add. No exemplo, a pesquisa devolve false porque o Integer não é igual a nenhuma das cadeias de caracteres guardadas. HashSet aceita null: contains(null) devolve true apenas se o conjunto contiver null.

A pesquisa usa uma tabela de dispersão e demora tempo constante se os códigos de dispersão distribuírem bem os elementos pelos compartimentos da tabela. Se redefinires equals, redefine também hashCode: objetos iguais têm de ter o mesmo código de dispersão, mas ter o mesmo código não implica que sejam iguais.

Enquanto um objeto estiver no conjunto, não alteres os dados que afetam equals ou hashCode. Depois de uma alteração desse tipo, contains pode não encontrar nem sequer esse mesmo objeto.

Exemplos

import java.util.HashSet;

public class Main {
    public static void main(String[] args) {
        HashSet<String> words = new HashSet<>();
        words.add("java");

        System.out.println(words.contains(new String("java")));
        System.out.println(words.contains("JAVA"));
        System.out.println(words.contains(Integer.valueOf(42)));
        System.out.println(words.contains(null));

        words.add(null);
        System.out.println(words.contains(null));
    }
}

Resultado

true
false
false
false
true

`new String("java")` cria de propósito um objeto distinto com o mesmo texto. A comparação de cadeias de caracteres distingue maiúsculas de minúsculas, pelo que `"JAVA"` não corresponde. É válido procurar um `Integer`, mas a pesquisa devolve `false`. Procurar `null` devolve `false` antes de `add(null)` e `true` depois.

Lições relacionadas

  • Java · Lição 55 · Básico · Versão: 2

Fontes