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

CKTIS / Java

Long.equals: igualdade de valores em objetos Long

`Long.equals` compara os valores guardados em objetos `Long`. Ao contrário de `==` entre duas referências, não verifica a identidade dos objetos.

Versão: Java SE 21

Sintaxe

public boolean equals(Object obj)

// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);

Long.equals é um método de instância de java.lang.Long que redefine Object.equals(Object). Só devolve true se o argumento for um Long que contém o mesmo valor long. Devolve false se o valor for diferente, se o objeto for de outro tipo ou se o argumento for null. As duas referências não têm de apontar para o mesmo objeto.

O parâmetro é do tipo Object. Se a for um Long que contém 42, a.equals(42L) devolve true porque 42L é convertido em Long por boxing. Em contrapartida, a.equals(42) devolve false porque 42 é convertido em Integer. O método não converte valores entre tipos wrapper.

Com dois operandos do tipo Long, == compara as referências, não os números guardados. Long.valueOf(long) reutiliza sempre objetos em cache para os valores de -128 a 127, inclusive, e pode fazê-lo para outros valores. Por isso, não uses == para comparar os valores de dois objetos Long. Com dois operandos primitivos long, == compara os números. Com um Long e um long primitivo, Java extrai o valor do Long por unboxing antes da comparação. Fazer unboxing de null lança NullPointerException.

a.equals(null) devolve false se a não for null. Se o próprio a for null, a.equals(b) lança NullPointerException. Se qualquer uma das duas referências Long puder ser null, usa Objects.equals(a, b): devolve true se ambas forem null, false se apenas uma for null e, nos restantes casos, aplica Long.equals.

Exemplos

import java.util.Objects;

public class LongEquality {
    public static void main(String[] args) {
        Long a = Long.valueOf(42L);
        Long b = Long.valueOf(42L);
        Long missing = null;

        System.out.println(a.equals(b));
        System.out.println(a.equals(43L));
        System.out.println(a.equals(42));
        System.out.println(a.equals(null));
        System.out.println(a == b);
        System.out.println(a == 42L);
        System.out.println(Objects.equals(a, missing));
        System.out.println(Objects.equals(missing, null));
    }
}

Resultado

true
false
false
false
true
true
false
true

As primeiras quatro linhas mostram os resultados para o mesmo valor `Long`, um valor diferente, um argumento `Integer` e um argumento `null`. As duas comparações com `==` imprimem `true`, mas por motivos diferentes: a primeira compara referências ao mesmo objeto em cache e a segunda compara valores após unboxing. As últimas duas linhas mostram `Objects.equals` com um e com dois argumentos `null`.

Lições relacionadas

  • Java · Lição 4 · Avançado · Versão: 2

Fontes