CKTIS / Java
Long.equals: rovnosť hodnôt objektov Long
`Long.equals` porovnáva hodnoty uložené v objektoch `Long`. Na rozdiel od operátora `==` medzi dvoma referenciami netestuje identitu objektov.
Verzia: Java SE 21
Syntax
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals je inštančná metóda triedy java.lang.Long, ktorá prepisuje Object.equals(Object). Vracia true len vtedy, keď je argument objektom Long s rovnakou hodnotou long. Pri inej hodnote, inom type objektu alebo argumente null vráti false. Obe referencie nemusia odkazovať na ten istý objekt.
Parameter má typ Object. Ak a odkazuje na objekt Long s hodnotou 42, a.equals(42L) vráti true, pretože 42L sa zabalí do objektu Long. Naopak, a.equals(42) vráti false, pretože 42 sa zabalí do objektu Integer. Metóda nekonvertuje hodnoty medzi obalovými typmi.
Pri dvoch operandoch typu Long porovnáva == referencie, nie uložené čísla. Long.valueOf(long) vždy používa objekty z vyrovnávacej pamäte pre hodnoty od -128 do 127 vrátane a môže ich používať aj pre iné hodnoty. Na porovnanie hodnôt dvoch objektov Long preto nepoužívaj ==. Pri dvoch primitívnych operandoch long porovnáva == čísla. Pri jednom operande Long a druhom primitívnom long Java pred porovnaním rozbalí hodnotu z objektu Long. Rozbalenie null vyvolá NullPointerException.
a.equals(null) vráti false, ak a nie je null. Ak je samotné a rovné null, volanie a.equals(b) vyvolá NullPointerException. Ak môže byť ktorákoľvek z dvoch referencií Long rovná null, použi Objects.equals(a, b): pre dve hodnoty null vráti true, pre práve jednu false a inak použije Long.equals.
Príklady
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));
}
}Výsledok
true false false false true true false true
Prvé štyri riadky ukazujú výsledky pre rovnakú hodnotu `Long`, inú hodnotu, argument typu `Integer` a argument `null`. Obe porovnania pomocou `==` vypíšu `true`, ale z odlišných dôvodov: prvé porovnáva referencie na ten istý objekt z vyrovnávacej pamäte, druhé porovnáva hodnoty po rozbalení. Posledné dva riadky ukazujú `Objects.equals` s jedným a s dvoma argumentmi `null`.
Súvisiace lekcie
- Java · Lekcia 4 · Pokročilá · Verzia: 2
Zdroje
- 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