WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.isBlank — leeren oder nur aus Leerraum bestehenden Text prüfen

String.isBlank prüft, ob eine Zeichenkette leer ist oder ausschließlich Leerraumzeichen gemäß Character.isWhitespace(int) enthält. Die Methode gibt boolean zurück und ist seit Java 11 verfügbar.

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

Syntax

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

String.isBlank ist eine Instanzmethode und wird als text.isBlank() aufgerufen. Sie gibt true zurück, wenn die Zeichenkette leer ist oder nur Leerraumzeichen enthält; andernfalls gibt sie false zurück. Die Methode ist seit Java 11 verfügbar; dieser Eintrag beschreibt Java SE 21.

Leerraumzeichen werden gemäß Character.isWhitespace(int) bestimmt. Dazu gehören Tabulatoren, Zeilenumbrüche und U+2003, nicht jedoch das geschützte Leerzeichen U+00A0. Daher ergibt visuell leerer Text nicht immer true.

isEmpty() prüft lediglich, ob die Länge null ist. trim().isEmpty() ist nicht gleichbedeutend mit isBlank(): trim() entfernt am Anfang und Ende Zeichen, deren Codes höchstens U+0020 betragen. Ein Aufruf von isBlank() auf null verursacht eine NullPointerException; soll null für fehlenden Inhalt stehen, verwenden Sie text == null || text.isBlank().

Beispiele

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

Ergebnis

true
true
false
true
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen