KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.isBlank — lege tekst of tekst met alleen witruimte controleren

String.isBlank controleert of een tekenreeks leeg is of alleen witruimte bevat volgens Character.isWhitespace(int). De methode retourneert boolean en is beschikbaar sinds Java 11.

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

Syntax

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

String.isBlank is een instantiemethode die je aanroept als text.isBlank(). De methode retourneert true als de tekenreeks leeg is of alleen witruimte bevat; anders retourneert ze false. De methode is beschikbaar sinds Java 11; deze beschrijving geldt voor Java SE 21.

Witruimte wordt bepaald volgens Character.isWhitespace(int). Dit omvat tabs, regeleinden en U+2003, maar niet de vaste spatie U+00A0. Tekst die er leeg uitziet, levert daarom niet altijd true op.

isEmpty() controleert alleen of de lengte nul is. trim().isEmpty() is niet hetzelfde als isBlank(): trim() verwijdert aan het begin en einde tekens met codes die niet hoger zijn dan U+0020. isBlank() aanroepen op null veroorzaakt een NullPointerException; gebruik text == null || text.isBlank() als null moet betekenen dat inhoud ontbreekt.

Voorbeelden

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

Resultaat

true
true
false
true
false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen