Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.compareToIgnoreCase(String) — porównywanie bez uwzględniania wielkości liter

Porównaj dwa napisy leksykograficznie bez uwzględniania wielkości liter i odczytaj ich kolejność ze znaku wyniku typu `int`.

Wersja: Java SE 21

Składnia

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) to metoda instancyjna klasy String. Wywołanie left.compareToIgnoreCase(right) porównuje dwa napisy leksykograficznie, ignorując wielkość liter. Zwraca int: wynik < 0 oznacza, że left jest przed right, == 0 oznacza równoważność w tym porównaniu, a > 0 oznacza, że left jest po right. Sprawdzaj znak, nie zakładaj, że wynik to zawsze -1, 0 lub 1.

W Java SE 21 znak wyniku jest taki jak w compareTo po zastosowaniu Character.toLowerCase(Character.toUpperCase(cp)) do każdego punktu kodowego Unicode cp obu napisów. Oryginalne napisy pozostają bez zmian. Metoda nie uwzględnia ustawień regionalnych. Do sortowania tekstu według reguł danego języka użyj java.text.Collator z odpowiednim Locale.

Użyj compareTo, gdy wielkość liter ma znaczenie dla kolejności leksykograficznej, a equalsIgnoreCase, gdy potrzebujesz tylko odpowiedzi typu boolean o równości bez uwzględniania wielkości liter. Jeśli left lub right to null, wywołanie left.compareToIgnoreCase(right) zgłosi NullPointerException. Dla niepustej referencji left wywołanie left.equalsIgnoreCase(null) zwraca false.

Przykłady

public class Main {
    public static void main(String[] args) {
        String first = "apple";
        String second = "Banana";

        System.out.println(first.compareToIgnoreCase("APPLE"));
        System.out.println(Integer.signum(first.compareToIgnoreCase(second)));
        System.out.println(Integer.signum(second.compareToIgnoreCase(first)));
    }
}

Wynik

0
-1
1

`apple` i `APPLE` dają wynik `0`. `apple` jest przed `Banana`, a odwrócenie argumentów porównania zmienia znak wyniku. W dwóch ostatnich wierszach `Integer.signum` sprowadza wyniki do `-1` i `1`.

Powiązane lekcje

  • Java · Lekcja 63 · Podstawowy · Wersja: 2

Źródła