Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.isBlank — verificar texto vazio ou composto apenas por espaços em branco

String.isBlank verifica se uma cadeia de caracteres está vazia ou contém apenas espaços em branco, segundo Character.isWhitespace(int). O método devolve boolean e está disponível desde Java 11.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

String.isBlank é um método de instância chamado como text.isBlank(). Devolve true se a cadeia estiver vazia ou contiver apenas espaços em branco; caso contrário, devolve false. Está disponível desde Java 11; esta entrada descreve Java SE 21.

Os espaços em branco são determinados segundo Character.isWhitespace(int). Incluem tabulações, mudanças de linha e U+2003, mas excluem o espaço não separável U+00A0. Por isso, um texto que parece vazio nem sempre devolve true.

isEmpty() verifica apenas se o comprimento é zero. trim().isEmpty() não é equivalente a isBlank(): trim() remove do início e do fim os caracteres cujos códigos não são superiores a U+0020. Chamar isBlank() em null provoca uma NullPointerException; se null dever significar conteúdo em falta, use text == null || text.isBlank().

Exemplos

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

Resultado

true
true
false
true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes