Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 Integer

Integer.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