CKTIS / Java
Long.equals: igualdad de valores en objetos Long
`Long.equals` compara los valores almacenados en objetos `Long`. A diferencia de `==` entre dos referencias, no comprueba la identidad de los objetos.
Versión: Java SE 21
Sintaxis
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals es un método de instancia de java.lang.Long que sobrescribe Object.equals(Object). Solo devuelve true si el argumento es un Long que contiene el mismo valor long. Devuelve false si el valor es distinto, si el objeto es de otro tipo o si el argumento es null. Las dos referencias no tienen por qué apuntar al mismo objeto.
El parámetro es de tipo Object. Si a es un Long que contiene 42, a.equals(42L) devuelve true porque 42L se convierte en Long mediante boxing. En cambio, a.equals(42) devuelve false porque 42 se convierte en Integer. El método no convierte valores entre tipos envoltorio.
Con dos operandos de tipo Long, == compara las referencias, no los números almacenados. Long.valueOf(long) siempre reutiliza objetos de la caché para los valores de -128 a 127, ambos incluidos, y puede hacerlo también para otros valores. Por tanto, no uses == para comparar los valores de dos objetos Long. Con dos operandos primitivos long, == compara números. Con un Long y un long primitivo, Java extrae el valor del Long mediante unboxing antes de comparar. Si el Long es null, el unboxing lanza NullPointerException.
a.equals(null) devuelve false si a no es null. Si a es null, a.equals(b) lanza NullPointerException. Si cualquiera de las dos referencias Long puede ser null, usa Objects.equals(a, b): devuelve true si ambas son null, false si solo una lo es y, en los demás casos, aplica Long.equals.
Ejemplos
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
Las cuatro primeras líneas muestran los resultados para el mismo valor `Long`, un valor distinto, un argumento `Integer` y un argumento `null`. Las dos comparaciones con `==` imprimen `true`, pero por motivos distintos: la primera compara referencias al mismo objeto de la caché y la segunda compara valores después del unboxing. Las dos últimas líneas muestran `Objects.equals` con uno y con dos argumentos `null`.
Lecciones relacionadas
- Java · Lección 4 · Avanzado · Versión: 2
Fuentes
- 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