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

CKTIS / Java

List.clear() : vider une liste en Java

`List.clear()` retire tous les éléments d’une liste existante. La méthode ne renvoie aucune valeur et n’est pas prise en charge par toutes les listes.

Version : Java SE 21

Syntaxe

void clear()

list.clear();

List.clear() est une méthode d’instance de l’interface java.util.List. Elle s’appelle sans argument, sous la forme list.clear(). Son type de retour void signifie qu’elle ne renvoie aucune valeur. Si l’appel réussit, list.size() renvoie 0 et list.isEmpty() renvoie true.

La méthode modifie la liste existante au lieu d’en créer une nouvelle. Si deux variables désignent la même liste, toutes deux désignent la liste vidée après l’appel. Affecter une nouvelle liste à l’une des variables ne vide pas la liste d’origine.

Vider une liste est une opération facultative. ArrayList la prend en charge, mais les listes créées avec List.of(...) ou List.copyOf(...) lèvent une UnsupportedOperationException, même si elles sont déjà vides. Pour vider une copie sans modifier l’original, créez d’abord new ArrayList<>(list), puis appelez clear() sur la copie.

Exemples

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>(List.of("A", "B"));
        List<String> sameList = items;

        System.out.println(items.size());
        items.clear();
        System.out.println(items.size());
        System.out.println(sameList.isEmpty());
    }
}

Résultat

2
0
true

`items` et `sameList` désignent la même `ArrayList`. La sortie affiche la taille `2` avant l’appel, la taille `0` après l’appel, puis `true` pour `sameList.isEmpty()`.

Leçons associées

  • Java · Leçon 54 · Débutant · Version : 2

Sources