CKTIS / Java
Long.equals: rovnost hodnot objektů Long
`Long.equals` porovnává hodnoty uložené v objektech `Long`. Na rozdíl od operátoru `==` mezi dvěma referencemi netestuje identitu objektů.
Verze: Java SE 21
Syntaxe
public boolean equals(Object obj)
// Instance call, where value is a non-null java.lang.Long:
boolean same = value.equals(other);Long.equals je instanční metoda třídy java.lang.Long, která přepisuje Object.equals(Object). Vrací true jen tehdy, když je argument objektem Long se stejnou hodnotou long. Jiná hodnota, jiný typ objektu nebo argument null vedou k výsledku false. Obě reference nemusí ukazovat na tentýž objekt.
Parametr má typ Object. Pokud a odkazuje na objekt Long s hodnotou 42, výraz a.equals(42L) vrátí true, protože 42L se zabalí do objektu Long. Naproti tomu a.equals(42) vrátí false, protože 42 se zabalí do objektu Integer. Metoda nepřevádí hodnoty mezi obalovými typy.
U dvou operandů typu Long porovnává == reference, nikoli uložená čísla. Long.valueOf(long) vždy používá objekty z mezipaměti pro hodnoty od -128 do 127 včetně a může je používat i pro jiné hodnoty. K porovnání hodnot dvou objektů Long proto nepoužívej ==. U dvou primitivních operandů long porovnává == čísla. Pokud je jeden operand Long a druhý primitivní long, Java před porovnáním hodnotu z objektu Long rozbalí. Rozbalení null vyvolá NullPointerException.
a.equals(null) vrátí false, pokud a není null. Pokud je samotné a rovno null, volání a.equals(b) vyvolá NullPointerException. Pokud může být kterákoli ze dvou referencí Long rovna null, použij Objects.equals(a, b): pro dvě hodnoty null vrátí true, pro právě jednu false a jinak použije Long.equals.
Pří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ýsledek
true false false false true true false true
První čtyři řádky ukazují výsledky pro stejnou hodnotu `Long`, jinou hodnotu, argument typu `Integer` a argument `null`. Obě porovnání pomocí `==` vypíšou `true`, ale z různých důvodů: první porovnává reference na tentýž objekt z mezipaměti, druhé porovnává hodnoty po rozbalení. Poslední dva řádky ukazují `Objects.equals` s jedním a se dvěma argumenty `null`.
Související lekce
- Java · Lekce 4 · Pokročilá · Verze: 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