Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.clear(): opróżnianie listy w Javie

`List.clear()` usuwa wszystkie elementy z istniejącej listy. Metoda nie zwraca wartości, a jej obsługa zależy od konkretnej listy.

Wersja: Java SE 21

Składnia

void clear()

list.clear();

List.clear() to metoda instancji interfejsu java.util.List. Wywołaj ją jako list.clear(), bez argumentów. Typ void oznacza, że metoda nie zwraca wartości. Po pomyślnym wywołaniu list.size() zwraca 0, a list.isEmpty() zwraca true.

Metoda modyfikuje tę samą listę, zamiast tworzyć nową. Jeśli dwie zmienne wskazują na tę samą listę, po wywołaniu obie wskazują na pustą listę. Przypisanie nowej listy do jednej ze zmiennych nie opróżnia pierwotnej listy.

Opróżnianie listy jest operacją opcjonalną. ArrayList ją obsługuje, ale listy utworzone przez List.of(...) lub List.copyOf(...) zgłaszają UnsupportedOperationException, nawet jeśli są już puste. Jeśli chcesz opróżnić kopię bez zmieniania źródła, najpierw utwórz new ArrayList<>(list) i wywołaj clear() na kopii.

Przykłady

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());
    }
}

Wynik

2
0
true

`items` i `sameList` wskazują na ten sam obiekt `ArrayList`. Wynik pokazuje rozmiar `2` przed wywołaniem, rozmiar `0` po nim oraz `true` dla `sameList.isEmpty()`.

Powiązane lekcje

  • Java · Lekcja 54 · Podstawowy · Wersja: 2

Źródła