CKTIS / Java
String.equals — porównywanie treści napisów
String.equals porównuje treść napisów z uwzględnieniem wielkości liter. Operator == porównuje tożsamość obiektów, a nie ich treść.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public boolean equals(Object anObject)String.equals ma sygnaturę public boolean equals(Object anObject). Zwraca true wyłącznie wtedy, gdy argument jest niepustą referencją do obiektu String o identycznej sekwencji znaków. Rozróżnia wielkość liter: "Java".equals("java") zwraca false.
Dla referencji operator == sprawdza, czy wskazują ten sam obiekt. W przykładzie new String("Java") tworzy osobny obiekt, dlatego a.equals(b) zwraca true, a a == b — false.
Argument innego typu, np. StringBuilder, daje false nawet przy takiej samej treści. a.equals(null) zwraca false, jeśli a nie jest null. Wywołanie metody na referencji null powoduje NullPointerException; zapis "Java".equals(missing) unika tego problemu.
Zakres dokumentacji: Java SE 21. Środowisko repozytorium i środowisko produkcyjne nie zostały potwierdzone.
Przykłady
public class Main {
public static void main(String[] args) {
String a = "Java";
String b = new String("Java");
String missing = null;
System.out.println(a.equals(b));
System.out.println(a == b);
System.out.println(a.equals("java"));
System.out.println(a.equals(new StringBuilder("Java")));
System.out.println(a.equals(missing));
System.out.println("Java".equals(missing));
}
}Wynik
true false false false false false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.