CKTIS / Java
List.subList — pohľad na časť zoznamu
`List.subList` vracia pohľad prepojený s pôvodným zoznamom, nie kópiu. Začiatočný index do rozsahu patrí, koncový index už nie.
Verzia: Java SE 21
Syntax
List<E> subList(int fromIndex, int toIndex)
list.subList(fromIndex, toIndex)
Valid bounds: 0 <= fromIndex <= toIndex <= list.size()List.subList(fromIndex, toIndex) je inštančná metóda rozhrania java.util.List<E>. Prijíma dva indexy typu int počítané od nuly a vracia List<E> pre polootvorený interval [fromIndex, toIndex). Volanie list.subList(2, 5) zahŕňa indexy 2, 3 a 4. Volanie list.subList(0, 4) vráti pohľad na prvé štyri prvky pôvodného zoznamu list, ak tento zoznam obsahuje aspoň štyri prvky. Indexy pohľadu začínajú od nuly.
Pre platné hranice platí 0 <= fromIndex <= toIndex <= list.size(). Dve rovnaké platné hranice dávajú prázdny pohľad, aj na konci zoznamu. Kontrakt rozhrania List uvádza pre neplatné hranice IndexOutOfBoundsException. ArrayList samostatne uvádza IllegalArgumentException pre fromIndex > toIndex, ak sú obidve hranice v povolenom rozsahu.
Pohľad zostáva prepojený s pôvodným zoznamom. Neštrukturálne zmeny vo vybranom rozsahu, napríklad nahradenie prvku metódou set, ak je podporovaná, sa prejavia v oboch smeroch. Pohľad podporuje tie isté voliteľné operácie ako pôvodný zoznam. Ak je podporovaná metóda clear, volanie list.subList(fromIndex, toIndex).clear() odstráni tento rozsah z pôvodného zoznamu.
Ak sa štruktúra pôvodného zoznamu zmení inak než prostredníctvom vráteného pohľadu, kontrakt už nedefinuje správanie pohľadu. Patria sem zmeny veľkosti a iné zmeny, ktoré môžu narušiť prebiehajúcu iteráciu, aj mimo vybraného rozsahu. Nespoliehajte sa na ConcurrentModificationException. Ak potrebujete nezávislý upraviteľný zoznam, vytvorte vopred new ArrayList<>(view). Ide o plytkú kópiu: samotné prvky sa nekopírujú.
Prí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ýsledok
[C, D, E] [A, B, X, Y, E, F] [X, Y, E] [A, B, F] [X, Y, E]
Pohľad sa začína prvkom `C`, takže `view.set(0, "X")` nahradí prvok na indexe 2 v pôvodnom zozname. Potom sa `list.set(3, "Y")` prejaví v pohľade. Po `view.clear()` pôvodný zoznam obsahuje `[A, B, F]`, ale kópia si ponechá `[X, Y, E]`.
Súvisiace lekcie
- Java · Lekcia 21 · Pokročilá · Verzia: 2
- Java · Lekcia 57 · Stredne pokročilá · Verzia: 2