CKTIS / Java
List.set — zastępowanie elementu listy według indeksu
`List.set(int,E)` zastępuje element pod istniejącym indeksem i zwraca poprzedni element. Nie zmienia rozmiaru listy ani nie przesuwa innych elementów.
Wersja: Java SE 21
Składnia
E set(int index, E element)List.set to metoda instancji interfejsu java.util.List<E>. Sygnatura List.set(int,E) oznacza, że list.set(index, element) przyjmuje indeks typu int i nowy element typu E, a zwraca element typu E, który wcześniej znajdował się pod tym indeksem.
Indeksy zaczynają się od zera. Poprawny indeks spełnia warunek 0 <= index < list.size(); poza tym zakresem metoda zgłasza IndexOutOfBoundsException, jeśli lista obsługuje set. W przeciwieństwie do add(index, element) metoda set nie wstawia elementu, nie przesuwa pozostałych i nie zmienia size(). Indeks list.size() jest dostępny przy wstawianiu na końcu, ale nie przy zastępowaniu.
set jest operacją opcjonalną: ArrayList ją obsługuje, ale lista z List.of(...) zgłasza UnsupportedOperationException. Stały rozmiar nie oznacza zakazu zastępowania: Arrays.asList(...) obsługuje set dla zgodnego elementu, a zmiana jest widoczna także w tablicy. Zależnie od listy niedozwolone null może spowodować NullPointerException, niedozwolony typ — ClassCastException, a inna niedozwolona właściwość elementu — IllegalArgumentException.
subList(from, to) to widok, nie kopia: obejmuje indeks from i pomija to. Indeksy widoku zaczynają się od zera, więc window.set(i, value) zmienia element o indeksie from + i na liście bazowej, jeśli ta obsługuje set. Po zmianie strukturalnej listy bazowej dokonanej z pominięciem tego widoku jego zachowanie jest niezdefiniowane.
Przykłady
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());
}
}
Wynik
old=C, D window=[X, Y] base=[A, B, X, Y, E] size=5 -> 5
Dwa wywołania `set` zastępują `C` i `D` znakami `X` i `Y` w postaci napisów. Indeksy `0` i `1` w `window` odpowiadają indeksom `2` i `3` w `base`; rozmiar listy bazowej nadal wynosi `5`.
Powiązane lekcje
- Java · Lekcja 21 · Zaawansowany · Wersja: 2
- Java · Lekcja 54 · Podstawowy · Wersja: 2
- Java · Lekcja 6 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 34 · Średniozaawansowany · Wersja: 2