CKTIS / Java
List.remove(Object): odstranění prvního výskytu
Odstraň první výskyt hodnoty, například jméno odběratele, a podle výsledku typu `boolean` zjisti, zda se něco odstranilo. Nezaměňuj hodnotu s indexem.
Verze: Java SE 21
Syntaxe
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) mění přímo seznam. Odstraní pouze prvek s nejnižším indexem i, pro který Objects.equals(o, get(i)) vrátí true. Další odpovídající prvky zůstávají. Pokud volání skončí bez výjimky, vrátí true, jestliže odstranilo prvek, nebo false, pokud nic neodpovídalo a seznam se nezměnil. V metodě unsubscribe je argument typu String jméno, ne pozice.
Přetížená varianta remove(int index) odstraní prvek na zadaném indexu počítaném od nuly a vrátí jej jako hodnotu typu E. Neplatný index vyvolá IndexOutOfBoundsException. U List<Integer> volání numbers.remove(1) odstraní prvek na indexu 1, zatímco numbers.remove(Integer.valueOf(7)) odstraní první výskyt hodnoty 7. Překladač vybírá podle typu argumentu, ne podle očekávaného návratového typu: přednost má varianta použitelná bez boxingu či unboxingu.
Odstranění je volitelná operace. ArrayList ji podporuje, ale seznam vytvořený pomocí List.of(...) vyvolá UnsupportedOperationException, i když nic neodpovídá. Podle implementace může odstranění podle hodnoty také vyvolat ClassCastException pro nekompatibilní typ nebo NullPointerException pro null, pokud seznam null nepovoluje.
Příklady
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);
}
}Výsledek
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Každé `new ArrayList<>(List.of(...))` vytvoří upravitelnou kopii. První `Ada` se odstraní, druhá zůstane a nepřítomnost `Sam` vede k výsledku `false`. Ze seznamu čísel se nejprve odstraní `9` na indexu `1` a potom první výskyt hodnoty `7`.
Související lekce
- Java · Lekce 22 · Středně pokročilá · Verze: 2
- Java · Lekce 26 · Středně pokročilá · Verze: 2