WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.set — Ein Listenelement per Index ersetzen

`List.set(int,E)` ersetzt das Element an einem vorhandenen Index und gibt das bisherige Element zurück. Die Listengröße und die Positionen der übrigen Elemente bleiben unverändert.

Version: Java SE 21

Syntax

E set(int index, E element)

List.set ist eine Instanzmethode von java.util.List<E>. Die Signatur List.set(int,E) bedeutet: list.set(index, element) erhält einen Index vom Typ int und ein neues Element vom Typ E und gibt das bisherige Element an diesem Index zurück, ebenfalls vom Typ E.

Indizes beginnen bei null. Gültig ist 0 <= index < list.size(); außerhalb dieses Bereichs löst eine Liste, die set unterstützt, eine IndexOutOfBoundsException aus. Anders als add(index, element) fügt set nichts ein, verschiebt keine anderen Elemente und ändert size() nicht. Der Index list.size() eignet sich zum Einfügen am Ende, nicht zum Ersetzen.

set ist optional: ArrayList unterstützt die Methode, eine Liste aus List.of(...) löst dagegen eine UnsupportedOperationException aus. Auch bei fester Größe kann Ersetzen möglich sein: Arrays.asList(...) unterstützt set mit einem kompatiblen Element; die Änderung ist auch im Array sichtbar. Je nach Liste kann ein unzulässiges null eine NullPointerException, ein unzulässiger Typ eine ClassCastException und eine andere unzulässige Elementeigenschaft eine IllegalArgumentException auslösen.

subList(from, to) ist eine Sicht, keine Kopie: from ist inklusive, to exklusive. Die Indizes der Sicht beginnen bei null. Daher ändert window.set(i, value) den Index from + i in der zugrunde liegenden Liste, sofern diese set unterstützt. Wird diese Liste auf anderem Weg als über die Sicht strukturell verändert, ist das Verhalten der Sicht nicht definiert.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        List<String> base = new ArrayList<>(List.of("A", "B", "C", "D", "E"));
        List<String> window = base.subList(2, 4);
        int sizeBefore = base.size();

        String firstOld = window.set(0, "X");
        String secondOld = window.set(1, "Y");

        System.out.println("old=" + firstOld + ", " + secondOld);
        System.out.println("window=" + window);
        System.out.println("base=" + base);
        System.out.println("size=" + sizeBefore + " -> " + base.size());
    }
}

Ergebnis

old=C, D
window=[X, Y]
base=[A, B, X, Y, E]
size=5 -> 5

Die beiden `set`-Aufrufe ersetzen `C` und `D` durch `X` und `Y`. Die Indizes `0` und `1` in `window` entsprechen `2` und `3` in `base`; die zugrunde liegende Liste hat weiterhin `5` Elemente.

Zugehörige Lektionen

  • Java · Lektion 21 · Fortgeschritten · Version: 2
  • Java · Lektion 54 · Grundlagen · Version: 2
  • Java · Lektion 6 · Mittlere Stufe · Version: 2
  • Java · Lektion 34 · Mittlere Stufe · Version: 2

Quellen