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 indexList.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