CKTIS / Java
Long.equals: jednakost vrijednosti objekata Long
`Long.equals` uspoređuje vrijednosti pohranjene u objektima `Long`. Za razliku od operatora `==` između dviju referenci, ne provjerava identitet objekata.
Verzija: 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 instancijska metoda klase java.lang.Long koja nadjačava Object.equals(Object). Vraća true samo ako je argument objekt Long koji sadrži istu vrijednost long. Za različitu vrijednost, drugi tip objekta ili argument null vraća false. Dvije reference ne moraju upućivati na isti objekt.
Parametar je tipa Object. Ako je a objekt Long s vrijednošću 42, a.equals(42L) vraća true jer se 42L omata u objekt Long. Nasuprot tome, a.equals(42) vraća false jer se 42 omata u objekt Integer. Metoda ne pretvara vrijednosti između omotačkih tipova.
S dva operanda tipa Long, == uspoređuje reference, a ne pohranjene brojeve. Long.valueOf(long) za vrijednosti od -128 do 127 uključivo uvijek ponovno upotrebljava objekte iz predmemorije, a to može činiti i za druge vrijednosti. Zato ne koristi == za usporedbu vrijednosti dvaju objekata Long. S dva primitivna operanda long, == uspoređuje brojeve. Kad je jedan operand Long, a drugi primitivni long, Java prije usporedbe raspakira vrijednost iz objekta Long. Raspakiravanje null izaziva NullPointerException.
a.equals(null) vraća false ako a nije null. Ako je sam a jednak null, poziv a.equals(b) izaziva NullPointerException. Ako bilo koja od dviju referenci Long može biti null, koristi Objects.equals(a, b): metoda vraća true ako su obje null, false ako je samo jedna null, a inače primjenjuje Long.equals.
Primjeri
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
Prva četiri retka prikazuju rezultate za istu vrijednost `Long`, različitu vrijednost, argument tipa `Integer` i argument `null`. Obje usporedbe operatorom `==` ispisuju `true`, ali iz različitih razloga: prva uspoređuje reference na isti objekt iz predmemorije, a druga uspoređuje vrijednosti nakon raspakiravanja. Posljednja dva retka prikazuju `Objects.equals` s jednim odnosno dvama argumentima `null`.
Povezane lekcije
- Java · Lekcija 4 · Napredno · Verzija: 2
Izvori
- 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