CKTIS / Java
java.util.List — uma coleção ordenada de elementos
List<E> descreve uma coleção ordenada com índices a começar em zero, que normalmente permite duplicados. Aprende a ler, adicionar e remover elementos e a distinguir uma lista modificável de uma cópia não modificável e de uma vista de intervalo.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> é uma interface de coleção ordenada que normalmente permite duplicados; E representa o tipo dos elementos. ArrayList é uma implementação modificável. List.size() indica o número de elementos e List.isEmpty() verifica se a lista está vazia. List.get(i) lê um elemento; os índices válidos satisfazem 0 <= i < size().
List.add(e) acrescenta um elemento no fim, enquanto List.add(i, e) o insere na posição i; também é permitido i == size(). List.addAll(c) acrescenta elementos pela ordem de iteração da coleção; List.addAll(i, c) insere-os na posição indicada. List.set(i, e) substitui um elemento e devolve o valor anterior, sem alterar o tamanho. List.clear() remove todos os elementos.
List.contains(o) verifica a presença com base na igualdade, e List.indexOf(o) devolve o primeiro índice ou -1. List.remove(i) remove e devolve o elemento no índice indicado; List.remove(o) remove a primeira ocorrência igual e indica se a lista foi alterada. Para List<Integer>, remove(1) remove pelo índice, enquanto remove(Integer.valueOf(1)) remove pelo valor.
List.of(...) cria uma lista não modificável; List.copyOf(c) fornece uma cópia instantânea não modificável que não é afetada se mais tarde forem acrescentados, removidos ou substituídos elementos na coleção de origem. Ambas as fábricas rejeitam null. Não fazem uma cópia profunda dos elementos: os objetos contidos podem continuar a mudar. As operações de modificação são opcionais na interface; as listas destas fábricas lançam UnsupportedOperationException se houver uma tentativa de modificação.
List.subList(from, to) devolve uma vista de [from, to), não uma cópia independente. As alterações suportadas através da vista afetam a lista subjacente; subList(from, to).clear() remove o intervalo. Uma alteração estrutural da lista subjacente fora da vista torna indefinida a semântica da vista. Em Java 21, ArrayList lança IndexOutOfBoundsException se from < 0 ou to > size(). Caso contrário, se from > to, o método lança IllegalArgumentException.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> items = new ArrayList<>(List.of("A", "B"));
items.add("C");
items.addAll(List.of("D", "E"));
System.out.println(items.size() + " " + items.get(0));
System.out.println(items.set(1, "X"));
System.out.println(items.contains("X") + " " + items.indexOf("X"));
System.out.println(items.remove(0));
System.out.println(items.remove("E"));
List<String> snapshot = List.copyOf(items);
items.subList(1, 3).clear();
System.out.println(items);
System.out.println(snapshot);
items.clear();
System.out.println(items.isEmpty());
}
}Resultado
5 A B true 1 A true [X] [X, C, D] true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.