Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.isBlank — sprawdzanie pustego tekstu i białych znaków

String.isBlank sprawdza, czy napis jest pusty lub zawiera wyłącznie białe znaki według Character.isWhitespace(int). Metoda zwraca boolean i jest dostępna od Java 11.

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

Składnia

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

String.isBlank to metoda instancji wywoływana jako text.isBlank(). Zwraca true dla pustego napisu lub napisu zawierającego wyłącznie białe znaki; w pozostałych przypadkach zwraca false. Jest dostępna od Java 11; wpis opisuje Java SE 21.

Białe znaki są rozpoznawane według Character.isWhitespace(int). Obejmuje to tabulator, znak nowego wiersza i spację U+2003, ale nie spację nierozdzielającą U+00A0. Dlatego wizualnie pusty tekst nie zawsze daje true.

isEmpty() sprawdza wyłącznie długość równą zero. trim().isEmpty() nie jest równoważne isBlank(): trim() usuwa z końców znaki o kodach nie większych niż U+0020. Wywołanie isBlank() na null powoduje NullPointerException; jeśli null ma oznaczać brak treści, użyj text == null || text.isBlank().

Przykłady

public class Main {
    public static void main(String[] args) {
        String[] values = {"", " \t\n", "Java", "\u2003", "\u00A0"};
        for (String value : values) {
            System.out.println(value.isBlank());
        }
    }
}

Wynik

true
true
false
true
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła