Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 index

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

Zdroje