CKTIS / Java
Integer.equals: gelijk wrappertype en gelijke waarde, niet objectidentiteit
`Integer.equals` controleert het wrappertype van het argument en de opgeslagen `int`-waarde. Bij twee `Integer`-referenties controleert `==` de objectidentiteit.
Versie: Java SE 21
Syntax
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) is een instantiemethode van java.lang.Integer die Object.equals(Object) overschrijft. De methode geeft alleen true terug als het argument een Integer met dezelfde int-waarde is; de referenties hoeven niet naar hetzelfde object te wijzen. Als a de waarde 42 bevat, geeft a.equals(42) true terug omdat 42 door boxing een Integer wordt. a.equals(42L) geeft daarentegen false terug: 42L wordt een Long en de methode vergelijkt geen getallen van verschillende wrappertypen.
Als a en b allebei van het type Integer zijn, controleert a == b of ze naar hetzelfde object wijzen of allebei null zijn. Integer.valueOf(int) houdt waarden van -128 tot en met 127 in een cache en kan ook andere waarden cachen. Gebruik daarom geen == om de waarden van twee Integer-objecten te vergelijken. In a == 42L is 42L juist een primitieve long: a wordt door unboxing omgezet in een primitieve waarde en de vergelijking is numeriek. Unboxing van null veroorzaakt een NullPointerException.
Als a niet null is, geeft a.equals(null) false terug. Als a zelf null is, veroorzaakt a.equals(b) een NullPointerException. Gebruik Objects.equals(a, b) als een van beide Integer-referenties null kan zijn: het resultaat is true als beide null zijn, false als precies één null is, en anders wordt Integer.equals gebruikt.
Voorbeelden
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));
}
}Resultaat
true true true false true false true
De eerste twee resultaten zijn om verschillende redenen `true`: de waarden zijn gelijk en `Integer.valueOf(42)` hergebruikt het object uit de cache. Vergelijk `a.equals(42L)` met `a == 42L`: de eerste expressie controleert het wrappertype, de tweede vergelijkt getallen.
Gerelateerde lessen
- Java · Les 4 · Gevorderd · Versie: 2
Bronnen
- 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