Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

List.subList — vista su un intervallo della lista

`List.subList` restituisce una vista collegata alla lista originale, non una copia. L’indice iniziale è incluso e quello finale è escluso.

Versione: Java SE 21

Sintassi

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

List.subList(fromIndex, toIndex) è un metodo di istanza di java.util.List<E>. Accetta due indici int a partire da zero e restituisce una List<E> per l’intervallo semiaperto [fromIndex, toIndex). list.subList(2, 5) comprende gli indici 2, 3 e 4. list.subList(0, 4) restituisce una vista sui primi quattro elementi della lista originale list, purché questa contenga almeno quattro elementi. Anche gli indici della vista partono da zero.

Gli estremi validi rispettano 0 <= fromIndex <= toIndex <= list.size(). Due estremi validi uguali producono una vista vuota, anche alla fine della lista. Il contratto di List indica IndexOutOfBoundsException per estremi non validi. ArrayList documenta separatamente IllegalArgumentException per fromIndex > toIndex quando entrambi gli estremi rientrano nei limiti consentiti.

La vista resta collegata alla lista originale. Le modifiche non strutturali nell’intervallo selezionato, come la sostituzione di un elemento con set se l’operazione è supportata, si riflettono in entrambe le direzioni. La vista supporta le stesse operazioni facoltative della lista originale. Se clear è supportata, list.subList(fromIndex, toIndex).clear() rimuove quell’intervallo dalla lista originale.

Se la struttura della lista originale viene modificata senza passare per la vista restituita, il contratto non ne definisce più il comportamento. Ciò comprende i cambiamenti di dimensione e altre modifiche che possono interferire con un’iterazione in corso, anche al di fuori dell’intervallo selezionato. Non fare affidamento su ConcurrentModificationException. Se serve una lista indipendente e modificabile, crea prima new ArrayList<>(view). È una copia superficiale: gli elementi stessi non vengono copiati.

Esempi

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

Risultato

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

La vista inizia da `C`, quindi `view.set(0, "X")` sostituisce l’elemento all’indice 2 della lista originale. Poi `list.set(3, "Y")` si riflette nella vista. Dopo `view.clear()`, la lista originale contiene `[A, B, F]`, mentre la copia conserva `[X, Y, E]`.

Lezioni correlate

  • Java · Lezione 21 · Avanzato · Versione: 2
  • Java · Lezione 57 · Intermedio · Versione: 2

Fonti