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

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 Integer

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