CKTIS / Java
Integer.equals: stesso tipo wrapper e stesso valore, non identità
`Integer.equals` verifica il tipo wrapper dell’argomento e il valore `int` che contiene. Con due riferimenti `Integer`, `==` verifica invece l’identità dell’oggetto.
Versione: Java SE 21
Sintassi
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) è un metodo di istanza di java.lang.Integer che ridefinisce Object.equals(Object). Restituisce true solo se l’argomento è un Integer con lo stesso valore int; non occorre che i riferimenti puntino allo stesso oggetto. Se a contiene 42, a.equals(42) restituisce true perché 42 viene convertito in un Integer tramite boxing. Invece a.equals(42L) restituisce false: 42L diventa un Long e il metodo non confronta numericamente valori di tipi wrapper diversi.
Se a e b sono entrambi di tipo Integer, a == b verifica se puntano allo stesso oggetto oppure se entrambi sono null. Integer.valueOf(int) conserva in cache i valori da -128 a 127 inclusi e può conservarne altri; quindi non usare == per confrontare i valori di due oggetti Integer. In a == 42L, invece, 42L è un long primitivo: a viene convertito in un valore primitivo tramite unboxing e il confronto è numerico. L’unboxing di null genera una NullPointerException.
Se a non è null, a.equals(null) restituisce false. Se a è null, la chiamata a.equals(b) genera una NullPointerException. Se uno dei due riferimenti Integer può essere null, usa Objects.equals(a, b): restituisce true se entrambi sono null, false se uno solo è null e applica Integer.equals se nessuno è null.
Esempi
import java.util.Objects;
public class Main {
public static void main(String[] args) {
Integer a = Integer.valueOf(42);
Integer b = Integer.valueOf(42);
System.out.println(a.equals(b));
System.out.println(a == b);
System.out.println(a.equals(42));
System.out.println(a.equals(42L));
System.out.println(a == 42L);
System.out.println(a.equals(null));
System.out.println(Objects.equals(null, null));
}
}Risultato
true true true false true false true
I primi due risultati sono entrambi `true` per motivi diversi: i valori coincidono e `Integer.valueOf(42)` riutilizza l’oggetto in cache. Confronta `a.equals(42L)` con `a == 42L`: la prima espressione verifica il tipo wrapper, la seconda confronta numeri.
Lezioni correlate
- Java · Lezione 4 · Avanzato · Versione: 2
Fonti
- Java SE 21 API — Integer.equals(Object)
- Java SE 21 API — Integer.valueOf(int)
- 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
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke