WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Long.equals: Wertgleichheit von Long-Objekten

`Long.equals` vergleicht die in `Long`-Objekten gespeicherten Werte. Anders als `==` bei zwei Referenzen prüft die Methode nicht die Objektidentität.

Version: Java SE 21

Syntax

public boolean equals(Object obj)

// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);

Long.equals ist eine Instanzmethode von java.lang.Long und überschreibt Object.equals(Object). Sie liefert nur dann true, wenn das Argument ein Long mit demselben long-Wert ist. Bei einem anderen Wert, einem anderen Objekttyp oder einem null-Argument liefert sie false. Die beiden Referenzen müssen nicht auf dasselbe Objekt zeigen.

Der Parameter hat den Typ Object. Enthält a als Long den Wert 42, liefert a.equals(42L) den Wert true, weil 42L durch Boxing zu einem Long wird. Dagegen liefert a.equals(42) den Wert false, weil 42 zu einem Integer wird. Die Methode wandelt keine Werte zwischen Wrapper-Typen um.

Bei zwei Operanden vom Typ Long vergleicht == die Referenzen, nicht die gespeicherten Zahlen. Long.valueOf(long) verwendet für Werte von -128 bis einschließlich 127 immer zwischengespeicherte Objekte und kann dies auch für andere Werte tun. Verwende == daher nicht zum Wertvergleich zweier Long-Objekte. Bei zwei primitiven long-Operanden vergleicht == Zahlen. Ist ein Operand ein Long und der andere ein primitiver long, entpackt Java das Long vor dem Vergleich. Beim Entpacken von null wird eine NullPointerException ausgelöst.

a.equals(null) liefert false, wenn a nicht null ist. Ist a selbst null, löst a.equals(b) eine NullPointerException aus. Kann eine der beiden Long-Referenzen null sein, verwende Objects.equals(a, b): Bei zweimal null liefert die Methode true, bei genau einmal null liefert sie false, und sonst vergleicht sie mit Long.equals.

Beispiele

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

Ergebnis

true
false
false
false
true
true
false
true

Die ersten vier Zeilen zeigen die Ergebnisse für denselben `Long`-Wert, einen anderen Wert, ein `Integer`-Argument und ein `null`-Argument. Beide `==`-Vergleiche ergeben `true`, aber aus unterschiedlichen Gründen: Der erste vergleicht Referenzen auf dasselbe zwischengespeicherte Objekt, der zweite vergleicht Werte nach dem Entpacken. Die letzten beiden Zeilen zeigen `Objects.equals` mit einem beziehungsweise zwei `null`-Argumenten.

Zugehörige Lektionen

  • Java · Lektion 4 · Fortgeschritten · Version: 2

Quellen