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
- 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