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

CKTIS / Java

String.isEmpty — verificar se uma cadeia está vazia

String.isEmpty() verifica se uma cadeia tem comprimento zero. Não considera os espaços como texto vazio e exige uma referência diferente de null. Utilize isBlank() para verificar se o texto está vazio ou contém apenas espaços em branco.

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

Sintaxe

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

String.isEmpty é um método de instância com a assinatura public boolean isEmpty(). Não recebe argumentos e devolve true exatamente quando length() == 0; caso contrário, devolve false. Chame-o num objeto, por exemplo, com text.isEmpty(), e não como método estático.

A cadeia vazia "" não contém caracteres. A cadeia " " contém um espaço, pelo que a chamada a isEmpty() devolve false. O método não remove espaços em branco. Para aceitar texto vazio ou texto que contenha apenas espaços em branco reconhecidos por Character.isWhitespace, utilize isBlank().

null não é uma cadeia vazia. Chamar text.isEmpty() quando text tem o valor null provoca uma NullPointerException. A condição text != null && text.isEmpty() verifica com segurança se uma cadeia existente está vazia; para null, devolve false.

O exemplo demonstra estas diferenças. Esta descrição diz respeito a Java SE 21; não confirma a versão do ambiente de execução de produção nem afirma que o exemplo tenha sido executado.

Exemplos

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

Resultado

true
false
false
true
false

O resultado esperado mostra que `""` é uma cadeia vazia, que `" "` contém apenas um espaço em branco mas não está vazia e que `"Java"` não está vazia. Para `null`, a condição `text != null && text.isEmpty()` devolve `false` sem chamar `isEmpty()`.

Fontes