CKTIS / Java
Comparable — přirozené uspořádání objektů
java.lang.Comparable<T> definuje přirozené uspořádání objektů pomocí compareTo(T o). Výsledek určuje pořadí, nikoli vzdálenost mezi hodnotami.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> definuje přirozené úplné uspořádání. Comparable.compareTo, deklarovaná jako int compareTo(T o), vrací zápornou hodnotu, nulu nebo kladnou hodnotu, pokud je tento objekt vzhledem k argumentu menší, rovnocenný v uspořádání, nebo větší. Rozhoduje znaménko, nikoli přesně -1 nebo 1.
Kontrakt vyžaduje opačná znaménka při prohození argumentů, tranzitivitu a stejná znaménka porovnání vůči každému třetímu objektu pro objekty, které se porovnávají jako nula. Výjimka v jednom směru vyžaduje výjimku také v opačném směru.
Důrazně se doporučuje, aby compareTo == 0 odpovídalo equals; případné odchylky zdokumentujte. Bez této shody může uspořádaná množina odmítnout nerovný objekt jako duplicitu. compareTo(null) vyvolá NullPointerException; nekompatibilní typ může způsobit ClassCastException.
Příklad řadí Score pomocí Arrays.sort. Použití Integer.compare místo odčítání zabraňuje přetečení; jediné pole recordu zajišťuje, že jeho uspořádání odpovídá equals.
Příklady
import java.util.Arrays;
public class Main {
record Score(int points) implements Comparable<Score> {
@Override
public int compareTo(Score other) {
return Integer.compare(points, other.points);
}
}
public static void main(String[] args) {
Score[] scores = {new Score(30), new Score(10), new Score(20)};
Arrays.sort(scores);
for (Score score : scores) {
System.out.println(score.points());
}
}
}Výsledek
10 20 30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.