Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.isEmpty — sprawdzanie pustego łańcucha

Metoda String.isEmpty() sprawdza, czy łańcuch ma długość zero. Nie uznaje spacji za pusty tekst i wymaga referencji różnej od null; do sprawdzania pustego tekstu lub samych białych znaków służy isBlank().

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public boolean isEmpty()
// Usage: text.isEmpty()

String.isEmpty to metoda instancji o sygnaturze public boolean isEmpty(). Nie przyjmuje argumentów i zwraca true dokładnie wtedy, gdy length() == 0; w przeciwnym razie zwraca false. Wywołuj ją na obiekcie, np. text.isEmpty(), a nie jako metodę statyczną.

Pusty łańcuch "" nie zawiera żadnych znaków. Łańcuch " " zawiera spację, więc jego isEmpty() zwraca false. Metoda nie usuwa białych znaków. Jeśli chcesz zaakceptować pusty tekst lub tekst zawierający wyłącznie białe znaki rozpoznawane przez Character.isWhitespace, użyj isBlank().

null nie jest pustym łańcuchem. Wywołanie text.isEmpty(), gdy text ma wartość null, powoduje NullPointerException. Warunek text != null && text.isEmpty() bezpiecznie sprawdza, czy istniejący łańcuch jest pusty; dla null daje false.

Przykład pokazuje te rozróżnienia. Opis dotyczy Java SE 21; nie potwierdza wersji środowiska produkcyjnego ani wykonania przykładu.

Przykłady

public class Main {
    public static void main(String[] args) {
        System.out.println("".isEmpty());
        System.out.println(" ".isEmpty());
        System.out.println("Java".isEmpty());
        System.out.println(" ".isBlank());

        String text = null;
        System.out.println(text != null && text.isEmpty());
    }
}

Wynik

true
false
false
true
false

Oczekiwany wynik pokazuje, że `""` jest pustym łańcuchem, `" "` zawiera wyłącznie biały znak, ale nie jest pustym łańcuchem, a `"Java"` nie jest puste. Dla `null` warunek `text != null && text.isEmpty()` daje `false` bez wywołania `isEmpty()`.

Źródła