CKTIS / Java
Integer.equals: stejný obalový typ a hodnota, nikoli identita objektu
`Integer.equals` ověřuje obalový typ argumentu a uloženou hodnotu `int`. U dvou referencí typu `Integer` naproti tomu operátor `==` ověřuje identitu objektu.
Verze: Java SE 21
Syntaxe
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) je instanční metoda třídy java.lang.Integer, která přepisuje Object.equals(Object). Vrací true pouze tehdy, když je argument objektem Integer se stejnou hodnotou int; obě reference nemusejí odkazovat na tentýž objekt. Pokud a obsahuje 42, a.equals(42) vrátí true, protože 42 se zabalí do Integer. Naproti tomu a.equals(42L) vrátí false: 42L se zabalí do Long a metoda číselně neporovnává různé obalové typy.
Jsou-li a i b typu Integer, výraz a == b zjišťuje, zda odkazují na tentýž objekt nebo zda jsou obě reference null. Integer.valueOf(int) používá mezipaměť pro hodnoty od -128 do 127 včetně a může ji používat i pro jiné hodnoty. Nepoužívej tedy == k porovnání hodnot dvou objektů Integer. Ve výrazu a == 42L je ale 42L primitivní long, takže se a rozbalí na primitivní hodnotu a porovnání je číselné. Rozbalení null vyvolá NullPointerException.
Pokud a není null, volání a.equals(null) vrátí false. Pokud je samotné a rovno null, volání a.equals(b) vyvolá NullPointerException. Pokud může být některá ze dvou referencí Integer rovna null, použij Objects.equals(a, b): vrátí true, pokud jsou obě null, false, pokud je právě jedna null, a jinak použije Integer.equals.
Příklady
import java.util.Objects;
public class Main {
public static void main(String[] args) {
Integer a = Integer.valueOf(42);
Integer b = Integer.valueOf(42);
System.out.println(a.equals(b));
System.out.println(a == b);
System.out.println(a.equals(42));
System.out.println(a.equals(42L));
System.out.println(a == 42L);
System.out.println(a.equals(null));
System.out.println(Objects.equals(null, null));
}
}Výsledek
true true true false true false true
První dva výsledky jsou `true` z různých důvodů: hodnoty jsou stejné a `Integer.valueOf(42)` znovu použije objekt z mezipaměti. Porovnej `a.equals(42L)` a `a == 42L`: první výraz ověřuje obalový typ, druhý porovnává čísla.
Související lekce
- Java · Lekce 4 · Pokročilá · Verze: 2
Zdroje
- Java SE 21 API — Integer.equals(Object)
- Java SE 21 API — Integer.valueOf(int)
- Java SE 21 API — Objects.equals(Object, Object)
- Java Language Specification, Java SE 21 — §15.21 Equality Operators
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke