Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

List.add — aggiungere un elemento a una lista

`List.add(E)` aggiunge un elemento in coda a una lista e restituisce `true` se l’operazione riesce. L’overload con indice inserisce un elemento nella posizione scelta.

Versione: Java SE 21

Sintassi

boolean add(E e)
void add(int index, E element)

In Java SE 21, l’interfaccia java.util.List<E> offre due overload di List.add. Il metodo con un solo argomento, List.add(E), aggiunge un elemento in coda alla lista esistente. E indica il tipo degli elementi, per esempio String in List<String>. Il metodo conserva l’ordine degli elementi già presenti e, se riesce, restituisce true, non un indice né una nuova lista. ArrayList ammette duplicati e valori null.

L’overload add(int index, E element) inserisce in una posizione numerata a partire da zero e ha tipo di ritorno void. L’elemento in quella posizione e quelli successivi si spostano di un posto a destra. Con index == size() si aggiunge in coda. Un indice fuori da 0 <= index && index <= size() non è valido e provoca una IndexOutOfBoundsException se l’inserimento è supportato. A differenza di set(index, element), l’inserimento non sostituisce alcun elemento.

L’aggiunta è un’operazione facoltativa: il solo tipo List<E> non garantisce che una determinata lista accetti aggiunte. Una chiamata non supportata lancia UnsupportedOperationException anziché restituire false. Una lista che supporta le aggiunte può comunque rifiutare null con NullPointerException, un tipo non ammesso con ClassCastException o una proprietà non ammessa dell’elemento con IllegalArgumentException.

List.of(...) crea una lista non modificabile. Arrays.asList(...) restituisce una lista basata su un array: gli elementi si possono sostituire, ma la dimensione è fissa. Nessuna delle due supporta add. Se ti serve una lista separata che possa crescere, usa new ArrayList<>(source). Aggiungere un elemento in coda alla copia non modifica la lista di origine.

Esempi

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> source = List.of("alpha", "beta");
        List<String> tags = new ArrayList<>(source);

        boolean added = tags.add("alpha");
        tags.add(1, "gamma");

        System.out.println(added);
        System.out.println(tags);
        System.out.println(source);

        try {
            source.add("delta");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Risultato

true
[alpha, gamma, beta, alpha]
[alpha, beta]
UnsupportedOperationException

Aggiungere un secondo `alpha` in coda a `tags` restituisce `true`. Inserire `gamma` all’indice `1` sposta `beta` e il secondo `alpha` a destra. `source` rimane invariata e rifiuta il tentativo di aggiungere `delta`.

Lezioni correlate

  • Java · Lezione 1 · Avanzato · Versione: 2
  • Java · Lezione 2 · Avanzato · Versione: 2
  • Java · Lezione 6 · Avanzato · Versione: 2
  • Java · Lezione 8 · Avanzato · Versione: 2
  • Java · Lezione 10 · Avanzato · Versione: 2
  • Java · Lezione 13 · Avanzato · Versione: 2
  • Java · Lezione 21 · Avanzato · Versione: 2
  • Java · Lezione 33 · Avanzato · Versione: 2
  • Java · Lezione 35 · Avanzato · Versione: 2
  • Java · Lezione 36 · Avanzato · Versione: 2
  • Java · Lezione 38 · Avanzato · Versione: 2
  • Java · Lezione 19 · Base · Versione: 2
  • Java · Lezione 29 · Base · Versione: 2
  • Java · Lezione 39 · Base · Versione: 2
  • Java · Lezione 44 · Base · Versione: 2
  • Java · Lezione 54 · Base · Versione: 2
  • Java · Lezione 57 · Base · Versione: 2
  • Java · Lezione 59 · Base · Versione: 2
  • Java · Lezione 62 · Base · Versione: 2
  • Java · Lezione 2 · Intermedio · Versione: 2
  • Java · Lezione 5 · Intermedio · Versione: 2
  • Java · Lezione 6 · Intermedio · Versione: 2
  • Java · Lezione 33 · Intermedio · Versione: 2
  • Java · Lezione 34 · Intermedio · Versione: 2
  • Java · Lezione 36 · Intermedio · Versione: 2
  • Java · Lezione 39 · Intermedio · Versione: 2
  • Java · Lezione 50 · Intermedio · Versione: 2

Fonti