Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

List.remove(Object): rimuovere la prima occorrenza

Rimuovi la prima occorrenza di un valore, per esempio il nome di un iscritto, e usa il risultato `boolean` per sapere se è stato rimosso un elemento. Non confondere valore e indice.

Versione: Java SE 21

Sintassi

boolean remove(Object o); // remove by value
E remove(int index);      // remove by zero-based index

List.remove(Object) modifica direttamente la lista. Rimuove solo l’elemento all’indice più basso i per cui Objects.equals(o, get(i)) restituisce true. Le altre occorrenze restano nella lista. Se la chiamata termina normalmente, restituisce true se ha rimosso un elemento o false se non trova corrispondenze e la lista rimane invariata. In unsubscribe, l’argomento di tipo String è un nome, non una posizione.

L’overload remove(int index) rimuove l’elemento all’indice indicato, contato a partire da zero, e lo restituisce come tipo E. Un indice non valido provoca IndexOutOfBoundsException. Con List<Integer>, numbers.remove(1) rimuove l’elemento all’indice 1, mentre numbers.remove(Integer.valueOf(7)) rimuove la prima occorrenza del valore 7. Il compilatore sceglie l’overload in base al tipo dell’argomento, non al tipo di ritorno atteso: ha la precedenza un overload applicabile senza boxing o unboxing.

La rimozione è facoltativa. ArrayList la supporta, ma una lista ottenuta con List.of(...) lancia UnsupportedOperationException anche in assenza di corrispondenze. A seconda dell’implementazione, la rimozione per valore può anche lanciare ClassCastException per un tipo incompatibile o NullPointerException per null se la lista non ammette null.

Esempi

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

public class Main {
    static boolean unsubscribe(List<String> names, String name) {
        return names.remove(name);
    }

    public static void main(String[] args) {
        List<String> names = new ArrayList<>(List.of("Ada", "Lin", "Ada"));
        System.out.println(unsubscribe(names, "Ada"));
        System.out.println(names);
        System.out.println(unsubscribe(names, "Sam"));
        System.out.println(names);

        List<Integer> numbers = new ArrayList<>(List.of(7, 9, 7));
        System.out.println(numbers.remove(1));
        System.out.println(numbers.remove(Integer.valueOf(7)));
        System.out.println(numbers);
    }
}

Risultato

true
[Lin, Ada]
false
[Lin, Ada]
9
true
[7]

Ogni `new ArrayList<>(List.of(...))` crea una copia modificabile. Il primo `Ada` viene rimosso, il secondo rimane e l’assenza di `Sam` dà `false`. Nella lista di numeri viene rimosso prima `9` all’indice `1`, poi la prima occorrenza del valore `7`.

Lezioni correlate

  • Java · Lezione 22 · Intermedio · Versione: 2
  • Java · Lezione 26 · Intermedio · Versione: 2

Fonti