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.