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