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

CKTIS / Java

List.subList — vue sur une portion de liste

`List.subList` renvoie une vue liée à la liste d’origine, pas une copie. La borne de début est incluse et la borne de fin est exclue.

Version : Java SE 21

Syntaxe

List<E> subList(int fromIndex, int toIndex)
list.subList(fromIndex, toIndex)
Valid bounds: 0 <= fromIndex <= toIndex <= list.size()

List.subList(fromIndex, toIndex) est une méthode d’instance de java.util.List<E>. Elle prend deux indices de type int comptés à partir de zéro et renvoie une List<E> pour l’intervalle semi-ouvert [fromIndex, toIndex). list.subList(2, 5) couvre les indices 2, 3 et 4. list.subList(0, 4) renvoie une vue sur les quatre premiers éléments de la liste d’origine list, à condition que celle-ci contienne au moins quatre éléments. Les indices de la vue commencent à zéro.

Les bornes valides respectent 0 <= fromIndex <= toIndex <= list.size(). Deux bornes valides égales donnent une vue vide, même en fin de liste. Le contrat de List indique IndexOutOfBoundsException pour les bornes invalides. ArrayList documente séparément IllegalArgumentException pour fromIndex > toIndex lorsque les bornes sont dans les limites autorisées.

La vue reste liée à la liste d’origine. Les modifications non structurelles dans la portion sélectionnée, comme le remplacement d’un élément avec set si cette opération est prise en charge, sont visibles dans les deux sens. La vue prend en charge les mêmes opérations facultatives que la liste d’origine. Si clear est prise en charge, list.subList(fromIndex, toIndex).clear() supprime cette portion de la liste d’origine.

Si la liste d’origine subit une modification structurelle autrement que par la vue renvoyée, le contrat ne définit plus le comportement de la vue. Cela inclut les changements de taille et d’autres changements susceptibles de perturber une itération en cours, même hors de la portion sélectionnée. Ne comptez pas sur une ConcurrentModificationException. Pour une liste indépendante et modifiable, créez au préalable new ArrayList<>(view). C’est une copie superficielle : les éléments eux-mêmes ne sont pas copiés.

Exemples

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

public class Main {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>(List.of("A", "B", "C", "D", "E", "F"));
        List<String> view = list.subList(2, 5);
        System.out.println(view);

        view.set(0, "X");
        list.set(3, "Y");
        System.out.println(list);
        System.out.println(view);

        List<String> copy = new ArrayList<>(view);
        view.clear();
        System.out.println(list);
        System.out.println(copy);
    }
}

Résultat

[C, D, E]
[A, B, X, Y, E, F]
[X, Y, E]
[A, B, F]
[X, Y, E]

La vue commence par `C` : `view.set(0, "X")` remplace donc l’élément d’indice 2 dans la liste d’origine. Ensuite, `list.set(3, "Y")` se reflète dans la vue. Après `view.clear()`, la liste d’origine contient `[A, B, F]`, mais la copie conserve `[X, Y, E]`.

Leçons associées

  • Java · Leçon 21 · Avancé · Version : 2
  • Java · Leçon 57 · Intermédiaire · Version : 2

Sources