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

CKTIS / Java

List.clear(): vyprázdnění seznamu v Javě

`List.clear()` odstraní všechny prvky z existujícího seznamu. Metoda nevrací žádnou hodnotu a ne každý seznam tuto operaci podporuje.

Verze: Java SE 21

Syntaxe

void clear()

list.clear();

List.clear() je instanční metoda rozhraní java.util.List. Volá se jako list.clear(), bez argumentů. Návratový typ void znamená, že metoda nevrací žádnou hodnotu. Po úspěšném volání vrátí list.size() hodnotu 0 a list.isEmpty() hodnotu true.

Metoda mění stávající seznam, nevytváří nový. Pokud dvě proměnné odkazují na stejný seznam, po volání obě odkazují na vyprázdněný seznam. Přiřazení nového seznamu jedné z proměnných původní seznam nevyprázdní.

Vyprázdnění je volitelná operace. ArrayList ji podporuje, ale seznamy vytvořené pomocí List.of(...) nebo List.copyOf(...) vyvolají výjimku UnsupportedOperationException, i když jsou už prázdné. Chceš-li vyprázdnit kopii beze změny původního seznamu, nejdříve vytvoř new ArrayList<>(list) a zavolej clear() na kopii.

Příklady

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

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>(List.of("A", "B"));
        List<String> sameList = items;

        System.out.println(items.size());
        items.clear();
        System.out.println(items.size());
        System.out.println(sameList.isEmpty());
    }
}

Výsledek

2
0
true

`items` i `sameList` odkazují na stejný objekt `ArrayList`. Výstup ukazuje velikost `2` před voláním, velikost `0` po něm a hodnotu `true` pro `sameList.isEmpty()`.

Související lekce

  • Java · Lekce 54 · Základní · Verze: 2

Zdroje