CKTIS / Java
Object.equals — rovnost objektů
Object.equals ve výchozím nastavení porovnává identitu objektů. Přepsáním této metody může třída definovat rovnost podle hodnoty.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public boolean equals(Object obj)Object.equals(Object obj) vrací boolean. Implementace v Object testuje identitu: pro nenulové reference se chová jako == a automaticky neporovnává pole. Třídy mohou tuto metodu přepsat.
Kontrakt vyžaduje reflexivitu, symetrii, tranzitivitu a konzistentní výsledky, dokud se nezmění data použitá při porovnání. Pro nenulové x musí x.equals(null) vrátit false.
Při přepsání equals je obvykle nutné přepsat také hashCode: stejné objekty musí mít stejné hashovací kódy; stejné hashovací kódy neznamenají, že jsou objekty stejné.
Příklad ukazuje zděděné chování: stejnou instanci, jinou instanci a argument null.
Příklady
public class Main {
public static void main(String[] args) {
Object a = new Object();
Object b = new Object();
Object same = a;
System.out.println(a.equals(same));
System.out.println(a.equals(b));
System.out.println(a.equals(null));
}
}Výsledek
true 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.