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.