WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.subList — Sicht auf einen Listenbereich

`List.subList` liefert eine mit der Ursprungsliste verknüpfte Sicht, keine Kopie. Der Startindex ist eingeschlossen, der Endindex ausgeschlossen.

Version: Java SE 21

Syntax

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

List.subList(fromIndex, toIndex) ist eine Instanzmethode von java.util.List<E>. Sie nimmt zwei nullbasierte int-Indizes entgegen und gibt eine List<E> für den halboffenen Bereich [fromIndex, toIndex) zurück. list.subList(2, 5) umfasst die Indizes 2, 3 und 4. list.subList(0, 4) gibt eine Sicht auf die ersten vier Elemente der Ursprungsliste list zurück, sofern diese mindestens vier Elemente enthält. Die Indizes der Sicht beginnen bei null.

Für gültige Grenzen gilt 0 <= fromIndex <= toIndex <= list.size(). Gleiche gültige Grenzen ergeben eine leere Sicht, auch am Listenende. Der Vertrag von List nennt für ungültige Grenzen IndexOutOfBoundsException. ArrayList dokumentiert gesondert IllegalArgumentException für fromIndex > toIndex, wenn beide Grenzen im zulässigen Bereich liegen.

Die Sicht bleibt mit der Ursprungsliste verknüpft. Nichtstrukturelle Änderungen im gewählten Bereich, etwa das Ersetzen eines Elements mit set, sofern unterstützt, sind in beide Richtungen sichtbar. Die Sicht unterstützt dieselben optionalen Operationen wie die Ursprungsliste. Wenn clear unterstützt wird, entfernt list.subList(fromIndex, toIndex).clear() den Bereich aus der Ursprungsliste.

Wird die Ursprungsliste auf anderem Weg als über die zurückgegebene Sicht strukturell verändert, ist das Verhalten der Sicht nicht mehr definiert. Dazu zählen Größenänderungen und andere Änderungen, die eine laufende Iteration stören können, auch außerhalb des gewählten Bereichs. Verlasse dich nicht auf eine ConcurrentModificationException. Erstelle vorher mit new ArrayList<>(view) eine eigenständige, veränderbare Liste, wenn du sie brauchst. Die Kopie ist flach: Die Elemente selbst werden nicht kopiert.

Beispiele

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

Ergebnis

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

Die Sicht beginnt bei `C`. Daher ersetzt `view.set(0, "X")` das Element am Index 2 der Ursprungsliste. Danach ist `list.set(3, "Y")` in der Sicht sichtbar. Nach `view.clear()` enthält die Ursprungsliste `[A, B, F]`, die Kopie behält `[X, Y, E]`.

Zugehörige Lektionen

  • Java · Lektion 21 · Fortgeschritten · Version: 2
  • Java · Lektion 57 · Mittlere Stufe · Version: 2

Quellen