Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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