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.