Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła