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