CKTIS / Java
List.set — Nahrazení prvku seznamu podle indexu
`List.set(int,E)` nahradí prvek na existujícím indexu a vrátí původní prvek. Velikost seznamu se nezmění a ostatní prvky se neposunou.
Verze: Java SE 21
Syntaxe
E set(int index, E element)List.set je instanční metoda rozhraní java.util.List<E>. Signatura List.set(int,E) říká, že list.set(index, element) přijímá index typu int a nový prvek typu E a vrací původní prvek na tomto indexu, rovněž typu E.
Indexy začínají nulou. Platný index splňuje 0 <= index < list.size(); mimo tento rozsah seznam, který set podporuje, vyvolá IndexOutOfBoundsException. Na rozdíl od add(index, element) metoda set nic nevkládá, neposouvá ostatní prvky ani nemění size(). Index list.size() lze použít ke vložení na konec, ne k nahrazení prvku.
set je volitelná operace: ArrayList ji podporuje, ale seznam z List.of(...) vyvolá UnsupportedOperationException. Pevná velikost nevylučuje nahrazení: Arrays.asList(...) podporuje set s kompatibilním prvkem a změna se projeví v poli. Podle seznamu může nepovolené null vyvolat NullPointerException, nepovolený typ ClassCastException a jiná nepovolená vlastnost prvku IllegalArgumentException.
subList(from, to) vrací pohled, nikoli kopii: index from zahrnuje, index to ne. Indexy pohledu začínají nulou, takže window.set(i, value) mění index from + i v podkladovém seznamu, pokud tento seznam podporuje set. Pokud se struktura podkladového seznamu změní jinak než prostřednictvím tohoto pohledu, chování pohledu není definováno.
Příklady
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());
}
}
Výsledek
old=C, D window=[X, Y] base=[A, B, X, Y, E] size=5 -> 5
Dvě volání `set` nahradí `C` a `D` prvky `X` a `Y`. Indexy `0` a `1` v `window` odpovídají indexům `2` a `3` v `base`; podkladový seznam má stále `5` prvků.
Související lekce
- Java · Lekce 21 · Pokročilá · Verze: 2
- Java · Lekce 54 · Základní · Verze: 2
- Java · Lekce 6 · Středně pokročilá · Verze: 2
- Java · Lekce 34 · Středně pokročilá · Verze: 2