KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Long.equals: waardegelijkheid van Long-objecten

`Long.equals` vergelijkt de waarden in `Long`-objecten. Anders dan `==` bij twee referenties test deze methode niet of ze naar hetzelfde object verwijzen.

Versie: 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 is een instantiemethode van java.lang.Long die Object.equals(Object) overschrijft. De methode geeft alleen true terug als het argument een Long met dezelfde long-waarde is. Een andere waarde, een ander objecttype of een null-argument levert false op. De twee referenties hoeven niet naar hetzelfde object te verwijzen.

De parameter heeft het type Object. Als a een Long met de waarde 42 is, geeft a.equals(42L) true terug, omdat 42L door boxing een Long wordt. Daarentegen geeft a.equals(42) false terug, omdat 42 door boxing een Integer wordt. De methode zet waarden niet om tussen wrappertypes.

Bij twee operanden van het type Long vergelijkt == de referenties, niet de opgeslagen getallen. Long.valueOf(long) hergebruikt altijd objecten uit de cache voor waarden van -128 tot en met 127 en kan dat ook voor andere waarden doen. Gebruik daarom geen == om de waarden van twee Long-objecten te vergelijken. Bij twee primitieve long-operanden vergelijkt == getallen. Bij een Long en een primitieve long haalt Java de waarde eerst uit de Long (unboxing). Unboxing van null leidt tot een NullPointerException.

a.equals(null) geeft false terug als a niet null is. Is a zelf null, dan leidt a.equals(b) tot een NullPointerException. Gebruik Objects.equals(a, b) als een van beide Long-referenties null kan zijn: de methode geeft true terug als beide null zijn, false als precies één null is, en gebruikt anders Long.equals.

Voorbeelden

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

Resultaat

true
false
false
false
true
true
false
true

De eerste vier regels tonen de resultaten voor dezelfde `Long`-waarde, een andere waarde, een `Integer`-argument en een `null`-argument. Beide vergelijkingen met `==` tonen `true`, maar om verschillende redenen: de eerste vergelijkt referenties naar hetzelfde object in de cache, de tweede vergelijkt waarden na unboxing. De laatste twee regels tonen `Objects.equals` met één respectievelijk twee `null`-argumenten.

Gerelateerde lessen

  • Java · Les 4 · Gevorderd · Versie: 2

Bronnen