Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Integer.equals: typ i wartość, nie tożsamość obiektu

Metoda `Integer.equals` sprawdza typ argumentu i zapisaną wartość `int`. Operator `==` dla dwóch referencji `Integer` sprawdza natomiast tożsamość obiektu.

Wersja: Java SE 21

Składnia

public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null Integer

Integer.equals(Object obj) to metoda instancyjna klasy java.lang.Integer, która przesłania Object.equals(Object). Zwraca true tylko wtedy, gdy argument jest obiektem Integer z taką samą wartością int; oba obiekty nie muszą być tym samym obiektem. Jeśli a przechowuje 42, to a.equals(42) zwraca true, bo 42 jest pakowane do Integer. Wywołanie a.equals(42L) zwraca false: 42L jest pakowane do Long, a metoda nie porównuje liczbowo różnych typów opakowujących.

Gdy a i b mają typ Integer, a == b sprawdza, czy wskazują ten sam obiekt albo czy obie referencje są null. Integer.valueOf(int) buforuje wartości od -128 do 127 włącznie i może buforować też inne, więc == nie jest testem równości wartości dwóch obiektów Integer. Natomiast w a == 42L operand 42L jest prymitywnym long, więc a jest rozpakowywane i porównanie jest liczbowe. Rozpakowanie null powoduje NullPointerException.

Dla a różnego od null wywołanie a.equals(null) zwraca false. Jeśli samo a jest null, wywołanie a.equals(b) powoduje NullPointerException. Gdy któraś z dwóch referencji Integer może być null, użyj Objects.equals(a, b): dla dwóch null zwraca true, dla dokładnie jednego null zwraca false, a dla dwóch niepustych referencji stosuje Integer.equals.

Przykłady

import java.util.Objects;

public class Main {
    public static void main(String[] args) {
        Integer a = Integer.valueOf(42);
        Integer b = Integer.valueOf(42);

        System.out.println(a.equals(b));
        System.out.println(a == b);
        System.out.println(a.equals(42));
        System.out.println(a.equals(42L));
        System.out.println(a == 42L);
        System.out.println(a.equals(null));
        System.out.println(Objects.equals(null, null));
    }
}

Wynik

true
true
true
false
true
false
true

Pierwsze dwa wyniki to `true` z różnych powodów: wartości są równe, a `Integer.valueOf(42)` używa buforowanego obiektu. Porównaj `a.equals(42L)` z `a == 42L`: pierwsze sprawdza typ opakowania, drugie porównuje liczby.

Powiązane lekcje

  • Java · Lekcja 4 · Zaawansowany · Wersja: 2

Źródła