Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.compareTo — porównywanie leksykograficzne

String.compareTo porównuje napisy leksykograficznie. Znak wyniku określa kolejność; zero oznacza jednakową treść.

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

Składnia

public int compareTo(String anotherString)
// Usage: int result = left.compareTo(right);

String.compareTo zwraca int: wynik ujemny oznacza, że lewy napis poprzedza prawy, dodatni — że następuje po nim. Zero odpowiada równości według equals.

Porównanie uwzględnia wielkość liter i wartości jednostek UTF-16 (char), nie reguły językowe. Wynikiem jest różnica pierwszych różnych jednostek; jeśli jeden napis jest prefiksem drugiego — różnica długości. Nie zakładaj wyniku wyłącznie -1, 0 lub 1: sprawdzaj znak.

Argument null powoduje NullPointerException. Do porównań zależnych od języka służy Collator.

Przykłady

public class Main {
    public static void main(String[] args) {
        System.out.println("cat".compareTo("car"));
        System.out.println("car".compareTo("cart"));
        System.out.println("cat".compareTo("cat"));
        System.out.println("A".compareTo("a") < 0);
    }
}

Wynik

2
-1
0
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła