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

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.

Fontes