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

CKTIS / Java

String.isEmpty — kontrola, zda je řetězec prázdný

String.isEmpty() kontroluje, zda má řetězec délku nula. Mezery nepovažuje za prázdný text a vyžaduje referenci odlišnou od null. Pro kontrolu prázdného textu nebo textu tvořeného pouze bílými znaky použijte isBlank().

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

Syntaxe

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

String.isEmpty je instanční metoda se signaturou public boolean isEmpty(). Nepřijímá žádné argumenty a vrátí true právě tehdy, když platí length() == 0; jinak vrátí false. Volá se na objektu, například text.isEmpty(), nikoli jako statická metoda.

Prázdný řetězec "" neobsahuje žádné znaky. Řetězec " " obsahuje mezeru, takže jeho volání isEmpty() vrátí false. Metoda bílé znaky neodstraňuje. Pokud chcete přijmout prázdný text nebo text obsahující pouze bílé znaky rozpoznané metodou Character.isWhitespace, použijte isBlank().

null není prázdný řetězec. Volání text.isEmpty(), když má text hodnotu null, vyvolá NullPointerException. Podmínka text != null && text.isEmpty() bezpečně ověří, zda je existující řetězec prázdný; pro null vrátí false.

Příklad ukazuje tyto rozdíly. Tento popis se vztahuje k Java SE 21; nepotvrzuje verzi běhového prostředí v produkci ani netvrdí, že byl příklad spuštěn.

Příklady

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

Výsledek

true
false
false
true
false

Očekávaný výstup ukazuje, že `""` je prázdný řetězec, `" "` obsahuje jen mezeru, a proto není prázdný, a `"Java"` také není prázdný řetězec. Pro `null` se podmínka `text != null && text.isEmpty()` vyhodnotí jako `false`, aniž se zavolá `isEmpty()`.

Zdroje