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

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.

Fontes