CKTIS / Java
java.util.List — une collection ordonnée d’éléments
List<E> décrit une collection ordonnée à indexation commençant à zéro, qui autorise généralement les doublons. Découvrez comment lire, ajouter et supprimer des éléments, et distinguer une liste modifiable, une copie non modifiable et une vue de plage.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> est une interface de collection ordonnée qui autorise généralement les doublons ; E désigne le type des éléments. ArrayList est une implémentation modifiable. List.size() indique le nombre d’éléments et List.isEmpty() vérifie si la liste est vide. List.get(i) lit un élément ; les indices valides respectent 0 <= i < size().
List.add(e) ajoute un élément à la fin, tandis que List.add(i, e) l’insère à la position i ; i == size() est également autorisé. List.addAll(c) ajoute les éléments dans l’ordre d’itération de la collection ; List.addAll(i, c) les insère à la position indiquée. List.set(i, e) remplace un élément et renvoie sa valeur précédente sans modifier la taille. List.clear() supprime tous les éléments.
List.contains(o) vérifie la présence selon l’égalité, et List.indexOf(o) renvoie le premier indice ou -1. List.remove(i) supprime et renvoie l’élément à l’indice indiqué ; List.remove(o) supprime la première occurrence égale et indique si la liste a changé. Pour List<Integer>, remove(1) supprime par indice, tandis que remove(Integer.valueOf(1)) supprime par valeur.
List.of(...) crée une liste non modifiable ; List.copyOf(c) fournit un instantané non modifiable qui n’est pas affecté par les ajouts, suppressions ou remplacements ultérieurs d’éléments dans la collection source. Les deux fabriques refusent null. Elles ne réalisent pas de copie profonde des éléments : les objets contenus peuvent toujours changer. Les opérations de modification sont facultatives dans l’interface ; les listes produites par ces fabriques lèvent UnsupportedOperationException en cas de tentative de modification.
List.subList(from, to) renvoie une vue de [from, to), et non une copie indépendante. Les modifications prises en charge via la vue affectent la liste sous-jacente ; subList(from, to).clear() supprime la plage. Une modification structurelle de la liste sous-jacente en dehors de la vue rend la sémantique de cette vue indéfinie. Dans Java 21, ArrayList lève IndexOutOfBoundsException si from < 0 ou to > size(). Dans le cas contraire, si from > to, la méthode lève IllegalArgumentException.
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"));
items.add("C");
items.addAll(List.of("D", "E"));
System.out.println(items.size() + " " + items.get(0));
System.out.println(items.set(1, "X"));
System.out.println(items.contains("X") + " " + items.indexOf("X"));
System.out.println(items.remove(0));
System.out.println(items.remove("E"));
List<String> snapshot = List.copyOf(items);
items.subList(1, 3).clear();
System.out.println(items);
System.out.println(snapshot);
items.clear();
System.out.println(items.isEmpty());
}
}Résultat
5 A B true 1 A true [X] [X, C, D] true
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.