База знанияИзпитен център
BGБългарски
Избери език13

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

Източници