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
- Java SE 21 API — Long.equals(Object)
- Java SE 21 API — Long.valueOf(long)
- 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