Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

java.util.Set — une collection sans doublons

Set<E> décrit une collection d’éléments uniques. Découvrez comment ajouter, vérifier, supprimer et compter les éléments, ainsi que la différence entre l’interface Set et l’implémentation HashSet.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

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> est une interface de collection sans doublons ; E désigne le type des éléments. Le contrat de Set définit les doublons à l’aide de equals, et non de l’identité des objets. Set ne garantit ni l’ordre d’itération ni l’accès par index.

Set.add(E) renvoie true lorsqu’un nouvel élément est ajouté ; pour un doublon, la méthode renvoie false et laisse l’ensemble inchangé. Set.size() renvoie le nombre d’éléments sous forme d’int (au maximum Integer.MAX_VALUE). Set.contains(Object) vérifie la présence d’un élément. Si l’appel à Set.remove(Object) se termine sans lever d’exception, la méthode renvoie true si elle a supprimé l’élément et false si l’élément était absent.

HashSet est une implémentation modifiable : elle autorise null, ne garantit aucun ordre d’itération et n’est pas synchronisée. La prise en charge de null dépend de l’implémentation. Les opérations de modification sont facultatives dans l’interface et peuvent lever UnsupportedOperationException même si l’élément est absent. Par exemple, Set.of("java").remove("missing") lève cette exception au lieu de renvoyer false.

Ne modifiez pas les champs qui influencent equals tant qu’un objet appartient à un ensemble : le comportement de celui-ci n’est alors pas spécifié. L’exemple utilise String et n’affiche que les résultats des opérations ; il ne dépend donc pas de l’ordre d’itération.

Exemples

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

Résultat

true
false
1
true
true
false
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources