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

CKTIS / Java

String.equals — comparar o conteúdo das cadeias de caracteres

String.equals compara o conteúdo das cadeias de caracteres, distinguindo maiúsculas de minúsculas. O operador == compara a identidade dos objetos, não o respetivo conteúdo.

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

Sintaxe

public boolean equals(Object anObject)

String.equals tem a assinatura public boolean equals(Object anObject). Devolve true apenas quando o argumento é uma referência não nula para um objeto String com a mesma sequência de caracteres. Distingue maiúsculas de minúsculas: "Java".equals("java") devolve false.

No caso das referências, == verifica se apontam para o mesmo objeto. No exemplo, new String("Java") cria um objeto separado; por isso, a.equals(b) devolve true, enquanto a == b devolve false.

Um argumento de outro tipo, como StringBuilder, resulta em false, mesmo que o conteúdo seja igual. a.equals(null) devolve false se a não for null. Invocar um método através de uma referência null provoca uma NullPointerException; escrever "Java".equals(missing) evita este problema.

Âmbito da documentação: Java SE 21. O ambiente de execução do repositório e o ambiente de produção não foram atestados.

Exemplos

public class Main {
    public static void main(String[] args) {
        String a = "Java";
        String b = new String("Java");
        String missing = null;

        System.out.println(a.equals(b));
        System.out.println(a == b);
        System.out.println(a.equals("java"));
        System.out.println(a.equals(new StringBuilder("Java")));
        System.out.println(a.equals(missing));
        System.out.println("Java".equals(missing));
    }
}

Resultado

true
false
false
false
false
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