CKTIS / Java
Long.equals: равенство на стойностите в обекти Long
`Long.equals` сравнява стойностите, съхранени в обекти `Long`. За разлика от `==` между две референции, методът не проверява дали обектът е един и същ.
Версия: Java SE 21
Синтаксис
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals е метод на екземпляр на java.lang.Long, който предефинира Object.equals(Object). Той връща true само ако аргументът е обект Long със същата стойност от тип long. При различна стойност, обект от друг тип или аргумент null връща false. Двете референции не е нужно да сочат към един и същ обект.
Параметърът е от тип Object. Ако a е обект Long със стойност 42, a.equals(42L) връща true, защото 42L се опакова в Long. За разлика от него a.equals(42) връща false, защото 42 се опакова в Integer. Методът не преобразува стойности между обвиващи типове.
При два операнда от тип Long операторът == сравнява референциите, а не съхранените числа. Long.valueOf(long) винаги използва повторно кеширани обекти за стойности от -128 до 127 включително и може да го прави и за други стойности. Затова не използвай ==, за да сравняваш стойностите на два обекта Long. При два примитивни операнда от тип long операторът == сравнява числата. При един Long и един примитивен long Java разопакова стойността от Long преди сравнението. Разопаковането на null хвърля NullPointerException.
a.equals(null) връща false, ако a не е null. Ако самото a е null, извикването a.equals(b) хвърля NullPointerException. Ако някоя от двете референции от тип Long може да е null, използвай Objects.equals(a, b): методът връща true, ако и двете са null, false, ако само едната е null, а в останалите случаи прилага Long.equals.
Примери
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));
}
}Резултат
true false false false true true false true
Първите четири реда показват резултатите при еднаква стойност в `Long`, различна стойност, аргумент от тип `Integer` и аргумент `null`. И двете сравнения с `==` извеждат `true`, но по различни причини: първото сравнява референции към един и същ кеширан обект, а второто сравнява стойности след разопаковане. Последните два реда показват `Objects.equals` с един и с два аргумента `null`.
Свързани уроци
- Java · Урок 4 · Напреднало · Версия: 2
Източници
- 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