CKTIS / Java
List.subList — pohled na část seznamu
`List.subList` vrací pohled propojený s původním seznamem, nikoli kopii. Počáteční index do rozsahu patří, koncový index už ne.
Verze: Java SE 21
Syntaxe
List<E> subList(int fromIndex, int toIndex)
list.subList(fromIndex, toIndex)
Valid bounds: 0 <= fromIndex <= toIndex <= list.size()List.subList(fromIndex, toIndex) je instanční metoda rozhraní java.util.List<E>. Přijímá dva indexy typu int počítané od nuly a vrací List<E> pro polootevřený interval [fromIndex, toIndex). Volání list.subList(2, 5) zahrnuje indexy 2, 3 a 4. Volání list.subList(0, 4) vrátí pohled na první čtyři prvky původního seznamu list, pokud tento seznam obsahuje alespoň čtyři prvky. Indexy pohledu začínají od nuly.
Platné meze splňují 0 <= fromIndex <= toIndex <= list.size(). Dvě stejné platné meze znamenají prázdný pohled, a to i na konci seznamu. Smlouva rozhraní List uvádí pro neplatné meze IndexOutOfBoundsException. ArrayList samostatně uvádí IllegalArgumentException pro fromIndex > toIndex, pokud obě meze leží v povoleném rozsahu.
Pohled zůstává propojený s původním seznamem. Nestrukturální změny ve vybraném rozsahu, například nahrazení prvku metodou set, je-li podporována, se projevují v obou směrech. Pohled podporuje stejné volitelné operace jako původní seznam. Pokud je podporována metoda clear, volání list.subList(fromIndex, toIndex).clear() odstraní daný rozsah z původního seznamu.
Pokud se struktura původního seznamu změní jinak než prostřednictvím vráceného pohledu, smlouva už nedefinuje chování pohledu. Patří sem změny velikosti i další změny, které mohou narušit probíhající iteraci, a to i mimo vybraný rozsah. Nespoléhejte na ConcurrentModificationException. Potřebujete-li nezávislý upravitelný seznam, vytvořte předem new ArrayList<>(view). Jde o mělkou kopii: samotné prvky se nekopírují.
Příklady
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);
}
}Výsledek
[C, D, E] [A, B, X, Y, E, F] [X, Y, E] [A, B, F] [X, Y, E]
Pohled začíná prvkem `C`, takže `view.set(0, "X")` nahradí prvek na indexu 2 v původním seznamu. Poté se `list.set(3, "Y")` projeví v pohledu. Po `view.clear()` původní seznam obsahuje `[A, B, F]`, ale kopie si ponechá `[X, Y, E]`.
Související lekce
- Java · Lekce 21 · Pokročilá · Verze: 2
- Java · Lekce 57 · Středně pokročilá · Verze: 2