Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.remove(Object): usuwanie pierwszego dopasowania

Usuń pierwsze wystąpienie wartości, np. nazwy subskrybenta, i odczytaj wynik `boolean`. Nie pomyl usuwania po wartości z usuwaniem po indeksie.

Wersja: Java SE 21

Składnia

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

List.remove(Object) modyfikuje listę w miejscu: usuwa tylko element o najmniejszym indeksie i, dla którego Objects.equals(o, get(i)) zwraca true. Pozostałe dopasowania zostają. Przy normalnym zakończeniu metoda zwraca true, jeśli coś usunęła, albo false, jeśli nic nie pasowało i lista się nie zmieniła. W unsubscribe argument typu String oznacza nazwę, a nie pozycję.

Przeciążenie remove(int index) usuwa element spod indeksu liczonego od zera, zwraca usunięty element typu E i zgłasza IndexOutOfBoundsException dla nieprawidłowego indeksu. Dla List<Integer> wywołanie numbers.remove(1) usuwa element spod indeksu 1, a numbers.remove(Integer.valueOf(7)) usuwa pierwszą wartość 7. Kompilator wybiera przeciążenie na podstawie typu argumentu, a nie oczekiwanego typu wyniku: pierwszeństwo ma dopasowanie bez boxingu lub unboxingu.

Usuwanie to operacja opcjonalna. ArrayList ją obsługuje, ale lista z List.of(...) zgłasza UnsupportedOperationException, nawet gdy nie ma dopasowania. Zależnie od implementacji usuwanie po wartości może też zgłosić ClassCastException dla niezgodnego typu albo NullPointerException dla null, jeśli lista nie dopuszcza null.

Przykłady

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);
    }
}

Wynik

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

Każde `new ArrayList<>(List.of(...))` tworzy modyfikowalną kopię. Pierwsze `Ada` znika, drugie zostaje, a brak `Sam` daje `false`. W liście liczb najpierw znika `9` spod indeksu `1`, a potem pierwsza wartość `7`.

Powiązane lekcje

  • Java · Lekcja 22 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 26 · Średniozaawansowany · Wersja: 2

Źródła