CKTIS / Java
List.addAll — acrescentar ou inserir elementos
Usa `List.addAll` para acrescentar os elementos de uma coleção ao fim de uma lista ou inseri-los num índice escolhido. O resultado do tipo `boolean` indica se a lista de destino foi alterada.
Versão: Java SE 21
Sintaxe
boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)Em Java SE 21, a interface java.util.List<E> disponibiliza duas sobrecargas de List.addAll. List.addAll(Collection) acrescenta elementos ao fim da lista de destino pela ordem em que o iterador da coleção de origem os devolve. Se a origem for outra lista, os seus elementos ficam a seguir aos que já estavam na lista de destino, pela ordem original. O método não ordena nem elimina duplicados. Collection<? extends E> significa que a origem não tem de ser uma lista e que o tipo declarado dos seus elementos pode ser E ou um subtipo de E.
List.addAll(int, Collection) insere os elementos a partir de um índice contado desde zero, mantendo a mesma ordem da origem. Os elementos existentes a partir da posição de inserção são deslocados para a direita. Os índices válidos vão de 0 a size(), inclusive; size() corresponde a acrescentar ao fim. Um índice fora desse intervalo pode causar uma IndexOutOfBoundsException.
Ambas as sobrecargas alteram a lista sobre a qual são chamadas. Devolvem true se a lista tiver sido alterada e false caso contrário. Por exemplo, acrescentar uma coleção vazia a uma ArrayList devolve false. O resultado não é uma nova lista. Para manter a primeira lista intacta, cria new ArrayList<>(first) e acrescenta os elementos da segunda lista a essa cópia.
Adicionar elementos é uma operação opcional: List.of(...) pode servir de origem, mas como destino lança UnsupportedOperationException. Se a lista de destino não suportar a operação, pode lançar esta exceção antes de verificar os argumentos. Um argumento null pode causar NullPointerException, tal como um elemento null se a lista de destino não o aceitar. Restrições à classe ou a outras propriedades de um elemento podem causar, respetivamente, ClassCastException ou IllegalArgumentException. Não alteres a origem durante a chamada: o comportamento é indefinido, mesmo quando uma lista não vazia é a sua própria origem.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> first = List.of("A", "B");
List<String> second = List.of("B", "C");
List<String> result = new ArrayList<>(first);
System.out.println(result.addAll(second));
System.out.println(result);
result.addAll(1, List.of("X", "Y"));
System.out.println(result);
System.out.println(result.addAll(List.of()));
}
}Resultado
true [A, B, B, C] [A, X, Y, B, B, C] false
O programa cria uma cópia modificável de `first`. Acrescentar `second` ao fim devolve `true` e mantém as duas ocorrências de `B`. A inserção no índice `1` coloca `X` e `Y` a seguir a `A`. Acrescentar uma coleção vazia devolve `false`.
Lições relacionadas
- Java · Lição 14 · Avançado · Versão: 2
- Java · Lição 54 · Básico · Versão: 2