Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.isBlank — kontrola prázdného textu nebo textu obsahujícího jen bílé znaky

String.isBlank kontroluje, zda je řetězec prázdný nebo obsahuje pouze bílé znaky podle Character.isWhitespace(int). Metoda vrací boolean a je dostupná od Javy 11.

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

Syntaxe

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

String.isBlank je instanční metoda, která se volá jako text.isBlank(). Vrátí true, pokud je řetězec prázdný nebo obsahuje pouze bílé znaky; jinak vrátí false. Je dostupná od Javy 11; tento záznam popisuje Java SE 21.

Bílé znaky se určují podle Character.isWhitespace(int). Patří sem tabulátory, znaky nového řádku a U+2003, ale nepatří sem nezalomitelná mezera U+00A0. Text, který vypadá prázdný, proto nemusí vždy vrátit true.

isEmpty() kontroluje pouze nulovou délku. trim().isEmpty() není totéž co isBlank(): trim() odstraňuje na začátku a konci znaky s kódy nejvýše U+0020. Volání isBlank() na null způsobí NullPointerException; pokud má null znamenat chybějící obsah, použijte text == null || text.isBlank().

Příklady

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

Výsledek

true
true
false
true
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje