CKTIS / Java
List.add(E) — aggiungere un elemento in coda a una lista
`List.add(E)` aggiunge un elemento in fondo alla lista esistente e restituisce `true` se la chiamata termina normalmente. Non tutte le liste supportano questa operazione.
Versione: Java SE 21
Sintassi
boolean add(E e)
boolean added = items.add(element);List.add(E) è il metodo con un solo argomento di java.util.List<E>. E è il tipo degli elementi, ad esempio Customer in un repository basato su List<Customer>. Il metodo modifica la lista esistente: il nuovo elemento va in fondo e gli elementi precedenti mantengono il loro ordine. Se la chiamata termina normalmente, restituisce true, non un indice né una nuova lista.
La lista memorizza il riferimento passato, non una copia dell’oggetto. Un’ArrayList può contenere più volte lo stesso riferimento; le modifiche all’oggetto condiviso sono visibili da ogni posizione che vi fa riferimento. Di norma le liste ammettono duplicati, quindi chiamate successive ad add permettono di registrare eventi o destinatari nell’ordine di aggiunta.
L’aggiunta in coda è facoltativa: una lista ottenuta con List.of(...) non è modificabile e lancia UnsupportedOperationException. Anche una lista che supporta l’aggiunta può rifiutare un elemento: NullPointerException se null non è ammesso, ClassCastException se la classe dell’elemento non è ammessa o IllegalArgumentException se non è ammessa un’altra proprietà dell’elemento. ArrayList ammette null.
L’overload add(int index, E element) restituisce void e inserisce in corrispondenza di un indice da 0 a size() inclusi, spostando gli elementi a partire da quella posizione. Per annullare una rimozione e ripristinare la posizione originale, usa l’indice salvato; add(element) aggiunge soltanto in coda. Da Java 21 anche addLast(E) aggiunge in coda, ma restituisce void.
Esempi
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<StringBuilder> items = new ArrayList<>();
StringBuilder first = new StringBuilder("Ada");
boolean added = items.add(first);
items.add(new StringBuilder("Lin"));
items.add(first);
System.out.println(added);
System.out.println(items);
System.out.println(items.get(0) == items.get(2));
first.append("!");
System.out.println(items);
}
}Risultato
true [Ada, Lin, Ada] true [Ada!, Lin, Ada!]
Il primo `true` è il risultato di `add`; il secondo è il risultato del confronto dei riferimenti con `==`. Dopo la modifica di `first`, entrambe le posizioni mostrano `Ada!` perché fanno riferimento allo stesso oggetto.
Lezioni correlate
- Java · Lezione 21 · Intermedio · Versione: 2
- Java · Lezione 22 · Intermedio · Versione: 2
- Java · Lezione 26 · Intermedio · Versione: 2
- Java · Lezione 27 · Intermedio · Versione: 2
- Java · Lezione 32 · Intermedio · Versione: 2