Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.subList — widok zakresu listy

Metoda `List.subList` zwraca widok zakresu powiązany z listą źródłową, a nie kopię. Początek zakresu jest włączony, a koniec wyłączony.

Wersja: Java SE 21

Składnia

List<E> subList(int fromIndex, int toIndex)
list.subList(fromIndex, toIndex)
Valid bounds: 0 <= fromIndex <= toIndex <= list.size()

List.subList(fromIndex, toIndex) to metoda instancji interfejsu java.util.List<E>. Przyjmuje dwa indeksy typu int, liczone od zera, i zwraca List<E> dla zakresu [fromIndex, toIndex). Wywołanie list.subList(2, 5) obejmuje indeksy 2, 3 i 4. Wywołanie list.subList(0, 4) zwraca widok pierwszych czterech elementów listy źródłowej list, jeśli ta lista ma co najmniej cztery elementy. Indeksy widoku zaczynają się od zera.

Poprawne granice spełniają warunek 0 <= fromIndex <= toIndex <= list.size(). Równe, poprawne granice dają pusty widok, również na końcu listy. Umowa List wskazuje IndexOutOfBoundsException dla niepoprawnych granic; dokumentacja ArrayList osobno podaje IllegalArgumentException dla fromIndex > toIndex, gdy granice są w dopuszczalnym przedziale.

To widok powiązany z listą źródłową, nie kopia. Zmiany niestrukturalne w wybranym zakresie, np. zastąpienie elementu za pomocą set, są widoczne w obu kierunkach, jeśli operacja jest obsługiwana. Widok obsługuje operacje opcjonalne dostępne na liście źródłowej. Jeśli obsługuje clear, wywołanie list.subList(fromIndex, toIndex).clear() usuwa zakres z listy źródłowej.

Jeśli zmienisz strukturę listy źródłowej inaczej niż przez zwrócony widok, umowa nie określa już zachowania tego widoku. Dotyczy to zmian rozmiaru i innych zmian mogących zakłócić trwającą iterację, nawet poza wybranym zakresem. Nie polegaj na ConcurrentModificationException. Jeśli potrzebujesz niezależnej, modyfikowalnej listy, utwórz wcześniej new ArrayList<>(view). To płytka kopia: same elementy nie są kopiowane.

Przykłady

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);
    }
}

Wynik

[C, D, E]
[A, B, X, Y, E, F]
[X, Y, E]
[A, B, F]
[X, Y, E]

Widok zaczyna się od `C`, więc `view.set(0, "X")` zmienia element o indeksie 2 na liście źródłowej. Następnie `list.set(3, "Y")` jest widoczne w widoku. Po `view.clear()` lista źródłowa zawiera `[A, B, F]`, a kopia zachowuje `[X, Y, E]`.

Powiązane lekcje

  • Java · Lekcja 21 · Zaawansowany · Wersja: 2
  • Java · Lekcja 57 · Średniozaawansowany · Wersja: 2

Źródła