Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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