CKTIS / Java
String.equals — porovnání obsahu řetězců
String.equals porovnává obsah řetězců a rozlišuje velká a malá písmena. Operátor == porovnává identitu objektů, nikoli jejich obsah.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public boolean equals(Object anObject)String.equals má signaturu public boolean equals(Object anObject). Vrací true pouze tehdy, když je argument nenulový odkaz na objekt String se zcela stejnou posloupností znaků. Rozlišuje velká a malá písmena: "Java".equals("java") vrací false.
U odkazů operátor == ověřuje, zda odkazují na stejný objekt. V příkladu vytvoří new String("Java") samostatný objekt, takže a.equals(b) vrací true, zatímco a == b vrací false.
Argument jiného typu, například StringBuilder, vrátí false i při shodném obsahu. a.equals(null) vrací false, pokud a není null. Volání metody přes odkaz null vyvolá NullPointerException; zápis "Java".equals(missing) tomuto problému předejde.
Rozsah dokumentace: Java SE 21. Běhové prostředí repozitáře ani produkční běhové prostředí nebyly potvrzeny.
Příklady
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));
}
}Výsledek
true false false false false false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.