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.