Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Collection.isEmpty() — sprawdzanie, czy kolekcja jest pusta

Metoda `Collection.isEmpty()` zwraca `true`, gdy kolekcja nie ma elementów, a w przeciwnym razie `false`. Nie zmienia zawartości kolekcji.

Wersja: Java SE 21

Składnia

boolean isEmpty()

W Java SE 21 Collection.isEmpty() to bezargumentowa metoda instancyjna interfejsu java.util.Collection<E>. Wywołaj ją na obiekcie kolekcji, np. items.isEmpty(). Zwraca wartość typu boolean: true, gdy nie ma żadnych elementów, i false, gdy jest co najmniej jeden.

Wywołanie nie zmienia kolekcji. Jeśli chcesz tylko sprawdzić, czy jest pusta, użyj items.isEmpty() zamiast items.size() == 0: oba wyrażenia dają ten sam wynik, ale pierwsze wprost wyraża zamiar. Aby sprawdzić, czy kolekcja nie jest pusta, użyj !items.isEmpty().

Pusta kolekcja to obiekt bez elementów, a nie referencja null. Jeśli items ma wartość null, wywołanie items.isEmpty() zgłasza NullPointerException. Jeśli kolekcja dopuszcza elementy o wartości null, tak jak ArrayList, taki element również liczy się jako element.

Przykłady

import java.util.ArrayList;
import java.util.Collection;

public class Main {
    public static void main(String[] args) {
        Collection<String> items = new ArrayList<>();
        System.out.println(items.isEmpty());

        items.add(null);
        System.out.println(items.isEmpty());

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

Wynik

true
false
true

Nowa `ArrayList` jest pusta, więc wynik to `true`. Po dodaniu `null` ma jeden element, więc wynik to `false`. Po wywołaniu `clear()` znów nie ma elementów i wynik to `true`.

Powiązane lekcje

  • Java · Lekcja 60 · Podstawowy · Wersja: 2
  • Java · Lekcja 61 · Podstawowy · Wersja: 2

Źródła