CKTIS / Java
Integer.equals: mesmo tipo invólucro e mesmo valor, não identidade
`Integer.equals` verifica o tipo invólucro do argumento e o valor `int` que este contém. Com duas referências `Integer`, `==` verifica a identidade do objeto.
Versão: Java SE 21
Sintaxe
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) é um método de instância de java.lang.Integer que redefine Object.equals(Object). Devolve true apenas se o argumento for um Integer com o mesmo valor int; as referências não têm de apontar para o mesmo objeto. Se a contiver 42, a.equals(42) devolve true porque 42 é convertido em Integer por boxing. Já a.equals(42L) devolve false: 42L é convertido em Long e o método não faz comparações numéricas entre tipos invólucro diferentes.
Se a e b forem ambos do tipo Integer, a == b verifica se apontam para o mesmo objeto ou se ambos são null. Integer.valueOf(int) guarda em cache os valores de -128 a 127, inclusive, e pode guardar outros; por isso, não uses == para comparar os valores de dois objetos Integer. Em a == 42L, pelo contrário, 42L é um long primitivo: a é convertido num valor primitivo por unboxing e a comparação é numérica. Fazer unboxing de null lança NullPointerException.
Se a não for null, a.equals(null) devolve false. Se a for null, a chamada a.equals(b) lança NullPointerException. Se qualquer uma das duas referências Integer puder ser null, usa Objects.equals(a, b): devolve true se ambas forem null, false se apenas uma for null e aplica Integer.equals se nenhuma for null.
Exemplos
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));
}
}Resultado
true true true false true false true
Os dois primeiros resultados são `true` por razões diferentes: os valores são iguais e `Integer.valueOf(42)` reutiliza o objeto em cache. Compara `a.equals(42L)` com `a == 42L`: a primeira expressão verifica o tipo invólucro; a segunda compara números.
Lições relacionadas
- Java · Lição 4 · Avançado · Versão: 2
Fontes
- 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