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