CKTIS / Java
List.addAll — aggiungere in coda o inserire elementi
Usa `List.addAll` per aggiungere gli elementi di una collezione in coda a una lista o inserirli a un indice scelto. Il valore `boolean` indica se la lista di destinazione è cambiata.
Versione: Java SE 21
Sintassi
boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)In Java SE 21, l’interfaccia java.util.List<E> offre due overload di List.addAll. List.addAll(Collection) aggiunge gli elementi in coda alla lista di destinazione, nell’ordine in cui li restituisce l’iteratore della collezione di origine. Se l’origine è un’altra lista, i suoi elementi seguono quelli già presenti nella destinazione, mantenendo l’ordine originale. Il metodo non ordina gli elementi e non rimuove i duplicati. Collection<? extends E> significa che l’origine non deve necessariamente essere una lista e che il tipo dichiarato dei suoi elementi può essere E o un sottotipo di E.
List.addAll(int, Collection) inserisce gli elementi a partire da un indice contato da zero, mantenendo lo stesso ordine di origine. Gli elementi già presenti dalla posizione di inserimento in poi si spostano verso destra. Gli indici validi vanno da 0 a size() inclusi; size() equivale a un’aggiunta in coda. Un indice fuori da questo intervallo può causare una IndexOutOfBoundsException.
Entrambi gli overload modificano la lista su cui vengono invocati. Restituiscono true se la lista è cambiata, altrimenti false. Per esempio, aggiungere una collezione vuota a un ArrayList restituisce false. Il risultato non è una nuova lista. Per lasciare intatta la prima lista, crea new ArrayList<>(first) e aggiungi a quella copia gli elementi della seconda lista.
L’aggiunta è un’operazione facoltativa: List.of(...) va bene come origine, ma come destinazione genera UnsupportedOperationException. Se la lista di destinazione non supporta l’operazione, può generare questa eccezione prima di controllare gli argomenti. Un argomento null può causare NullPointerException, così come un elemento null se la destinazione non lo ammette. Le restrizioni sulla classe o su altre proprietà di un elemento possono causare rispettivamente ClassCastException o IllegalArgumentException. Non modificare l’origine durante la chiamata: il comportamento è indefinito, anche quando una lista non vuota funge da origine di se stessa.
Esempi
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()));
}
}Risultato
true [A, B, B, C] [A, X, Y, B, B, C] false
Il programma crea una copia modificabile di `first`. Aggiungere `second` in coda restituisce `true` e mantiene entrambe le occorrenze di `B`. L’inserimento all’indice `1` mette `X` e `Y` dopo `A`. Aggiungere una collezione vuota restituisce `false`.
Lezioni correlate
- Java · Lezione 14 · Avanzato · Versione: 2
- Java · Lezione 54 · Base · Versione: 2