Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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