CKTIS / Java
Long.equals: enakost vrednosti objektov Long
`Long.equals` primerja vrednosti, shranjene v objektih `Long`. V nasprotju z operatorjem `==` med dvema referencama ne preverja identitete objektov.
Različica: Java SE 21
Sintaksa
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals je metoda primerka razreda java.lang.Long, ki prepiše Object.equals(Object). Vrne true samo, če je argument objekt Long z enako vrednostjo long. Drugačna vrednost, drug tip objekta ali argument null da rezultat false. Referenci se lahko nanašata na različna objekta.
Parameter je tipa Object. Če je a objekt Long z vrednostjo 42, a.equals(42L) vrne true, ker se 42L ovije v objekt Long. Nasprotno pa a.equals(42) vrne false, ker se 42 ovije v objekt Integer. Metoda ne pretvarja vrednosti med ovojnimi tipi.
Pri dveh operandih tipa Long operator == primerja referenci, ne shranjenih števil. Long.valueOf(long) za vrednosti od -128 do 127 vključno vedno znova uporabi objekte iz predpomnilnika, lahko pa jih uporabi tudi za druge vrednosti. Zato za primerjavo vrednosti dveh objektov Long ne uporabljaj ==. Pri dveh primitivnih operandih long operator == primerja števili. Če je en operand Long, drugi pa primitivni long, Java pred primerjavo razveže vrednost iz objekta Long (unboxing). Razvezava null sproži NullPointerException.
a.equals(null) vrne false, če a ni null. Če je a sam null, klic a.equals(b) sproži NullPointerException. Če je lahko katera koli od obeh referenc Long enaka null, uporabi Objects.equals(a, b): vrne true, če sta obe null, false, če je le ena null, sicer pa uporabi Long.equals.
Primeri
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));
}
}Rezultat
true false false false true true false true
Prve štiri vrstice prikazujejo rezultate za enako vrednost `Long`, drugačno vrednost, argument tipa `Integer` in argument `null`. Obe primerjavi z `==` izpišeta `true`, vendar iz različnih razlogov: prva primerja referenci na isti objekt iz predpomnilnika, druga primerja vrednosti po razvezavi. Zadnji dve vrstici prikazujeta `Objects.equals` z enim oziroma dvema argumentoma `null`.
Povezane lekcije
- Java · Lekcija 4 · Napredna · Različica: 2
Viri
- 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