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 IntegerInteger.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
- Java SE 21 API — Integer.equals(Object)
- Java SE 21 API — Integer.valueOf(int)
- 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
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke