CKTIS / Java
java.util.Set — uma coleção sem duplicados
Set<E> descreve uma coleção de elementos únicos. Aprende a adicionar, verificar, remover e contar elementos, e a distinguir a interface Set da implementação HashSet.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Set<E> values = new HashSet<>();
boolean added = values.add(element);
int count = values.size();
boolean present = values.contains(element);
boolean removed = values.remove(element);java.util.Set<E> é uma interface de coleção sem duplicados; E designa o tipo dos elementos. O contrato de Set define os duplicados através de equals, e não da identidade dos objetos. Set não garante nem a ordem de iteração nem o acesso por índice.
Set.add(E) devolve true quando é adicionado um novo elemento; no caso de um duplicado, devolve false e mantém o conjunto inalterado. Set.size() devolve o número de elementos como int (até Integer.MAX_VALUE). Set.contains(Object) verifica se um elemento está presente. Se a chamada a Set.remove(Object) terminar sem lançar uma exceção, o método devolve true se tiver removido o elemento e false se o elemento não estiver no conjunto.
HashSet é uma implementação modificável: permite null, não garante qualquer ordem de iteração e não é sincronizada. O suporte para null depende da implementação. As operações de alteração são opcionais na interface e podem lançar UnsupportedOperationException mesmo quando o elemento não está presente. Por exemplo, Set.of("java").remove("missing") lança essa exceção em vez de devolver false.
Não alteres os campos que afetam equals enquanto um objeto pertencer a um conjunto: nesse caso, o comportamento do conjunto não está especificado. O exemplo utiliza String e imprime apenas os resultados das operações, pelo que não depende da ordem de iteração.
Exemplos
import java.util.HashSet;
import java.util.Set;
public class SetDemo {
public static void main(String[] args) {
Set<String> tags = new HashSet<>();
System.out.println(tags.add("java"));
System.out.println(tags.add("java"));
System.out.println(tags.size());
System.out.println(tags.contains("java"));
System.out.println(tags.remove("java"));
System.out.println(tags.remove("java"));
System.out.println(tags.size());
}
}Resultado
true false 1 true true false 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.