Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Long.equals: uguaglianza dei valori degli oggetti Long

`Long.equals` confronta i valori contenuti negli oggetti `Long`. A differenza di `==` tra due riferimenti, non verifica l’identità degli oggetti.

Versione: Java SE 21

Sintassi

public boolean equals(Object obj)

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

Long.equals è un metodo di istanza di java.lang.Long che ridefinisce Object.equals(Object). Restituisce true solo se l’argomento è un Long che contiene lo stesso valore long. Un valore diverso, un oggetto di un altro tipo o un argomento null dà come risultato false. I due riferimenti non devono necessariamente puntare allo stesso oggetto.

Il parametro è di tipo Object. Se a è un Long che contiene 42, a.equals(42L) restituisce true perché 42L viene convertito in Long tramite boxing. Invece a.equals(42) restituisce false perché 42 viene convertito in Integer. Il metodo non converte i valori tra tipi wrapper.

Con due operandi di tipo Long, == confronta i riferimenti, non i numeri contenuti negli oggetti. Long.valueOf(long) riutilizza sempre oggetti dalla cache per i valori da -128 a 127 inclusi e può farlo anche per altri valori. Non usare quindi == per confrontare i valori di due oggetti Long. Con due operandi primitivi long, == confronta i numeri. Con un Long e un long primitivo, Java estrae il valore del Long tramite unboxing prima del confronto; l’unboxing di null genera una NullPointerException.

a.equals(null) restituisce false se a non è null. Se a stesso è null, a.equals(b) genera una NullPointerException. Se uno dei due riferimenti Long può essere null, usa Objects.equals(a, b): restituisce true se entrambi sono null, false se solo uno è null e negli altri casi applica Long.equals.

Esempi

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));
    }
}

Risultato

true
false
false
false
true
true
false
true

Le prime quattro righe mostrano i risultati per lo stesso valore `Long`, un valore diverso, un argomento `Integer` e un argomento `null`. Entrambi i confronti con `==` stampano `true`, ma per motivi diversi: il primo confronta riferimenti allo stesso oggetto nella cache, il secondo confronta i valori dopo l’unboxing. Le ultime due righe mostrano `Objects.equals` con uno e con due argomenti `null`.

Lezioni correlate

  • Java · Lezione 4 · Avanzato · Versione: 2

Fonti