Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje