CKTIS / Java
Long.equals : égalité des valeurs des objets Long
`Long.equals` compare les valeurs stockées dans les objets `Long`. Contrairement à `==` entre deux références, cette méthode ne vérifie pas l’identité des objets.
Version : Java SE 21
Syntaxe
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals est une méthode d’instance de java.lang.Long qui redéfinit Object.equals(Object). Elle renvoie true uniquement si l’argument est un Long qui contient la même valeur long. Une valeur différente, un autre type d’objet ou un argument null donne false. Les deux références n’ont pas besoin de désigner le même objet.
Le paramètre est de type Object. Si a est un Long qui contient 42, a.equals(42L) renvoie true parce que 42L est converti en Long par boxing. En revanche, a.equals(42) renvoie false parce que 42 est converti en Integer. La méthode ne convertit pas les valeurs d’un type enveloppe à un autre.
Avec deux opérandes de type Long, == compare les références et non les nombres stockés. Long.valueOf(long) réutilise toujours des objets mis en cache pour les valeurs de -128 à 127 inclus, et peut le faire pour d’autres valeurs. N’utilisez donc pas == pour comparer les valeurs de deux objets Long. Avec deux opérandes primitifs long, == compare les nombres. Avec un Long et un long primitif, Java extrait la valeur du Long par unboxing avant de comparer ; si le Long vaut null, cette opération déclenche une NullPointerException.
a.equals(null) renvoie false si a n’est pas null. Si a lui-même vaut null, a.equals(b) déclenche une NullPointerException. Si l’une ou l’autre des deux références Long peut valoir null, utilisez Objects.equals(a, b) : cette méthode renvoie true pour deux arguments null, false pour un seul et applique Long.equals dans les autres cas.
Exemples
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));
}
}Résultat
true false false false true true false true
Les quatre premières lignes montrent les résultats pour la même valeur `Long`, une valeur différente, un argument `Integer` et un argument `null`. Les deux comparaisons `==` affichent `true`, mais pour des raisons différentes : la première compare des références au même objet mis en cache, la seconde compare les valeurs après unboxing. Les deux dernières lignes montrent `Objects.equals` avec un puis deux arguments `null`.
Leçons associées
- Java · Leçon 4 · Avancé · Version : 2
Sources
- 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