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
- Java SE 21 API — Long.equals(Object)
- Java SE 21 API — Long.valueOf(long)
- Java SE 21 API — Objects.equals(Object, Object)
- Java Language Specification, Java SE 21 — §15.21 Equality Operators
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion