Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Long.equals: równość wartości obiektów Long

`Long.equals` porównuje wartości zapisane w obiektach `Long`. W odróżnieniu od `==` dla dwóch referencji nie sprawdza tożsamości obiektów.

Wersja: Java SE 21

Składnia

public boolean equals(Object obj)

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

Long.equals to metoda instancji java.lang.Long, która przesłania Object.equals(Object). Zwraca true tylko wtedy, gdy argument jest obiektem Long przechowującym tę samą wartość long. Dla innej wartości, innego typu obiektu lub argumentu null zwraca false. Dwie referencje nie muszą wskazywać na ten sam obiekt.

Parametr ma typ Object. Gdy a jest obiektem Long o wartości 42, a.equals(42L) zwraca true, ponieważ 42L jest pakowane do Long. Natomiast a.equals(42) zwraca false, ponieważ 42 jest pakowane do Integer. Metoda nie przelicza wartości między typami opakowującymi.

Dla dwóch operandów typu Long operator == porównuje referencje, a nie przechowywane liczby. Long.valueOf(long) zawsze używa obiektów z pamięci podręcznej dla wartości od -128 do 127 włącznie i może to robić także dla innych wartości. Nie używaj więc == do porównywania wartości dwóch obiektów Long. Dla dwóch prymitywnych wartości long operator == porównuje liczby. Gdy jeden operand ma typ Long, a drugi long, Java rozpakowuje Long przed porównaniem; rozpakowanie null powoduje NullPointerException.

a.equals(null) zwraca false, jeśli a nie jest null. Jeśli to a jest null, wywołanie a.equals(b) powoduje NullPointerException. Gdy którakolwiek z dwóch referencji Long może być null, użyj Objects.equals(a, b): dla dwóch wartości null zwraca true, dla dokładnie jednej false, a w pozostałym przypadku stosuje reguły Long.equals.

Przykłady

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

Wynik

true
false
false
false
true
true
false
true

Pierwsze cztery wiersze pokazują wynik dla tej samej wartości `Long`, innej wartości, argumentu typu `Integer` i argumentu `null`. Oba porównania `==` dają `true`, ale z różnych powodów: pierwsze porównuje referencje do tego samego obiektu z pamięci podręcznej, a drugie porównuje wartości po rozpakowaniu. Dwa ostatnie wiersze pokazują wynik `Objects.equals` dla jednego i dwóch argumentów `null`.

Powiązane lekcje

  • Java · Lekcja 4 · Zaawansowany · Wersja: 2

Źródła