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

CKTIS / Java

HashSet.add(E): adicionar um elemento a um conjunto

`HashSet.add(E)` devolve `true` ao inserir um novo elemento e `false` quando o conjunto já contém um elemento igual.

Versão: Java SE 21

Sintaxe

public boolean add(E e)

Em Java SE 21, HashSet.add(E) é um método de instância de java.util.HashSet<E>. Recebe um único elemento e do tipo E do conjunto, por exemplo, String em HashSet<String>.

Se o conjunto não contiver nenhum elemento e2 para o qual Objects.equals(e, e2) devolva true, o método insere e, aumenta o tamanho do conjunto em uma unidade e devolve true. Caso contrário, devolve false e deixa o conjunto inalterado: não substitui o elemento existente. HashSet aceita null, pelo que a primeira inserção de null devolve true; as seguintes devolvem false enquanto null estiver no conjunto.

Nas tuas próprias classes, garante que equals e hashCode são coerentes: objetos iguais têm de ter o mesmo código hash, mas ter o mesmo código hash não implica que os objetos sejam iguais. Não alteres os dados usados por estes métodos enquanto o objeto estiver no conjunto. HashSet não garante nenhuma ordem de iteração, nem sequer a ordem de inserção.

Usa if (tags.add(tag)) para executar código apenas se o elemento tiver sido inserido, sem chamar primeiro contains. Nem todos os Set se comportam assim: um conjunto criado com Set.of(...) não pode ser modificado, e chamar add nesse conjunto lança UnsupportedOperationException.

Exemplos

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

Resultado

true
false
true
false
2

`new String("java")` cria propositadamente um objeto diferente com o mesmo texto. A segunda chamada devolve `false` porque as cadeias de caracteres são iguais, e não por serem o mesmo objeto. No fim, o conjunto tem dois elementos: `"java"` e `null`.

Lições relacionadas

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

Fontes