Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.equalsIgnoreCase — porównywanie bez rozróżniania wielkości liter

String.equalsIgnoreCase porównuje napisy bez rozróżniania wielkości liter, niezależnie od ustawień regionalnych. Zwraca boolean.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase wymaga tej samej długości napisów i zgodności odpowiadających sobie punktów kodowych Unicode. Punkty są zgodne, gdy są identyczne albo dają ten sam wynik po Character.toLowerCase(Character.toUpperCase(int)).

Argument null daje false; wywołanie na odbiorcy null powoduje NullPointerException. W przeciwieństwie do tej metody equals rozróżnia wielkość liter.

Metoda nie uwzględnia ustawień regionalnych; do porównań zależnych od języka służy Collator. Nie utożsamia ß z SS: długości są różne.

Przykłady

public class Main {
    public static void main(String[] args) {
        System.out.println("Java".equalsIgnoreCase("jAvA"));
        System.out.println("Java".equals("jAvA"));
        System.out.println("Java".equalsIgnoreCase(null));
        System.out.println("ß".equalsIgnoreCase("SS"));
    }
}

Wynik

true
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