CKTIS / Java
Integer.equals : même type enveloppe et même valeur, sans test d’identité
`Integer.equals` vérifie le type enveloppe de l’argument et la valeur `int` contenue. Avec deux références `Integer`, `==` teste plutôt l’identité de l’objet.
Version : Java SE 21
Syntaxe
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) est une méthode d’instance de java.lang.Integer qui redéfinit Object.equals(Object). Elle renvoie true seulement si l’argument est un Integer contenant la même valeur int ; les deux références n’ont pas à désigner le même objet. Si a contient 42, a.equals(42) renvoie true parce que 42 est converti en Integer par boxing. En revanche, a.equals(42L) renvoie false : 42L devient un Long, et la méthode ne compare pas numériquement des objets de types enveloppes différents.
Si a et b sont tous deux de type Integer, a == b vérifie s’ils désignent le même objet ou s’ils valent tous deux null. Integer.valueOf(int) met en cache les valeurs de -128 à 127 inclus et peut en mettre d’autres en cache ; n’utilise donc pas == pour comparer les valeurs de deux objets Integer. Dans a == 42L, en revanche, 42L est de type primitif long : a est converti en valeur primitive par unboxing et la comparaison est numérique. L’unboxing de null lève une NullPointerException.
Si a n’est pas null, a.equals(null) renvoie false. Si a vaut null, l’appel a.equals(b) lève une NullPointerException. Si l’une ou l’autre des deux références Integer peut valoir null, utilise Objects.equals(a, b) : la méthode renvoie true si les deux valent null, false si une seule vaut null, et applique Integer.equals si aucune ne vaut null.
Exemples
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));
}
}Résultat
true true true false true false true
Les deux premiers résultats valent `true` pour des raisons différentes : les valeurs sont égales et `Integer.valueOf(42)` réutilise l’objet en cache. Compare `a.equals(42L)` et `a == 42L` : la première expression vérifie le type enveloppe, la seconde compare des nombres.
Leçons associées
- Java · Leçon 4 · Avancé · Version : 2
Sources
- 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