Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

List.subList — vista de um intervalo da lista

`List.subList` devolve uma vista ligada à lista de origem, não uma cópia. O índice inicial é incluído e o índice final é excluído.

Versão: Java SE 21

Sintaxe

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

List.subList(fromIndex, toIndex) é um método de instância de java.util.List<E>. Recebe dois índices int numerados a partir de zero e devolve uma List<E> para o intervalo semiaberto [fromIndex, toIndex). list.subList(2, 5) abrange os índices 2, 3 e 4. list.subList(0, 4) devolve uma vista dos primeiros quatro elementos da lista de origem list, desde que esta tenha pelo menos quatro elementos. Na vista, os índices também começam em zero.

Os limites válidos satisfazem 0 <= fromIndex <= toIndex <= list.size(). Dois limites válidos iguais dão uma vista vazia, mesmo no fim da lista. O contrato de List indica IndexOutOfBoundsException para limites inválidos. ArrayList documenta separadamente IllegalArgumentException para fromIndex > toIndex quando ambos os extremos estão dentro dos limites permitidos.

A vista mantém-se ligada à lista de origem. As alterações não estruturais no intervalo escolhido, como a substituição de um elemento com set quando a operação é suportada, refletem-se nos dois sentidos. A vista suporta as mesmas operações opcionais que a lista de origem. Se clear for suportada, list.subList(fromIndex, toIndex).clear() remove esse intervalo da lista de origem.

Se a lista de origem for alterada estruturalmente sem ser através da vista devolvida, o contrato deixa de definir o comportamento da vista. Isto inclui alterações ao tamanho e outras alterações que podem perturbar uma iteração em curso, mesmo fora do intervalo escolhido. Não conte com uma ConcurrentModificationException. Se precisar de uma lista independente e modificável, crie previamente new ArrayList<>(view). É uma cópia superficial: os próprios elementos não são copiados.

Exemplos

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

Resultado

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

A vista começa em `C`, pelo que `view.set(0, "X")` substitui o elemento no índice 2 da lista de origem. De seguida, `list.set(3, "Y")` reflete-se na vista. Após `view.clear()`, a lista de origem contém `[A, B, F]`, mas a cópia mantém `[X, Y, E]`.

Lições relacionadas

  • Java · Lição 21 · Avançado · Versão: 2
  • Java · Lição 57 · Intermédio · Versão: 2

Fontes