CKTIS / Java
Comparable — prirodzené usporiadanie objektov
java.lang.Comparable<T> definuje prirodzené usporiadanie objektov pomocou compareTo(T o). Výsledok určuje poradie, nie vzdialenosť medzi hodnotami.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> definuje prirodzené úplné usporiadanie. Comparable.compareTo, deklarovaná ako int compareTo(T o), vracia zápornú hodnotu, nulu alebo kladnú hodnotu, ak je tento objekt vzhľadom na argument menší, rovnocenný v usporiadaní alebo väčší. Rozhoduje znamienko, nie presne -1 alebo 1.
Kontrakt vyžaduje opačné znamienka pri zámene argumentov, tranzitivitu a rovnaké znamienka porovnania voči každému tretiemu objektu pre objekty, ktoré sa porovnávajú ako nula. Výnimka v jednom smere vyžaduje výnimku aj v opačnom smere.
Dôrazne sa odporúča, aby compareTo == 0 zodpovedalo equals; prípadné odchýlky zdokumentujte. Bez tejto zhody môže usporiadaná množina odmietnuť nerovný objekt ako duplicitu. compareTo(null) vyvolá NullPointerException; nekompatibilný typ môže spôsobiť ClassCastException.
Príklad triedi Score pomocou Arrays.sort. Použitie Integer.compare namiesto odčítania zabraňuje pretečeniu; jediné pole recordu zabezpečuje, že jeho usporiadanie zodpovedá equals.
Prí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ýsledok
10 20 30
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.