Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła