WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Integer.equals: gleicher Wrapper-Typ und Wert statt Objektidentität

`Integer.equals` prüft den Wrapper-Typ des Arguments und den gespeicherten `int`-Wert. Bei zwei `Integer`-Referenzen prüft `==` dagegen die Objektidentität.

Version: Java SE 21

Syntax

public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null Integer

Integer.equals(Object obj) ist eine Instanzmethode von java.lang.Integer und überschreibt Object.equals(Object). Sie liefert nur dann true, wenn das Argument ein Integer mit demselben int-Wert ist; die Referenzen müssen nicht auf dasselbe Objekt zeigen. Enthält a den Wert 42, liefert a.equals(42) den Wert true, weil 42 durch Boxing zu einem Integer wird. a.equals(42L) liefert dagegen false, weil 42L durch Boxing zu einem Long wird. Die Methode vergleicht keine Zahlen über verschiedene Wrapper-Typen hinweg.

Haben a und b beide den Typ Integer, prüft a == b, ob sie auf dasselbe Objekt zeigen oder beide null sind. Integer.valueOf(int) hält die Werte von -128 bis einschließlich 127 im Cache und kann auch andere Werte zwischenspeichern. Verwende == daher nicht zum Wertvergleich zweier Integer-Objekte. In a == 42L ist 42L dagegen ein primitiver long-Wert: a wird durch Unboxing entpackt, und der Vergleich ist numerisch. Unboxing von null löst eine NullPointerException aus.

Ist a nicht null, liefert a.equals(null) den Wert false. Ist a selbst null, löst a.equals(b) eine NullPointerException aus. Kann eine der beiden Integer-Referenzen null sein, verwende Objects.equals(a, b): Bei zweimal null liefert es true, bei genau einmal null liefert es false, andernfalls verwendet es Integer.equals.

Beispiele

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));
    }
}

Ergebnis

true
true
true
false
true
false
true

Die ersten beiden Ergebnisse sind aus unterschiedlichen Gründen `true`: Die Werte stimmen überein, und `Integer.valueOf(42)` verwendet das Objekt aus dem Cache. Vergleiche `a.equals(42L)` mit `a == 42L`: Der erste Ausdruck prüft den Wrapper-Typ, der zweite vergleicht Zahlen.

Zugehörige Lektionen

  • Java · Lektion 4 · Fortgeschritten · Version: 2

Quellen