CKTIS / Java
Comparable — prirodni poredak objekata
java.lang.Comparable<T> definira prirodni poredak objekata pomoću metode compareTo(T o). Rezultat određuje poredak, a ne udaljenost između vrijednosti.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> definira prirodni potpuni poredak. Comparable.compareTo, deklarirana kao int compareTo(T o), vraća negativnu vrijednost, nulu ili pozitivnu vrijednost kada je ovaj objekt redom manji, jednakovrijedan u poretku ili veći od argumenta. Važan je predznak, a ne točna vrijednost -1 ili 1.
Ugovor zahtijeva suprotne predznake pri zamjeni argumenata, tranzitivnost i jednake predznake usporedbe prema svakom trećem objektu za objekte koji se uspoređuju kao nula. Iznimka u jednom smjeru zahtijeva iznimku i u obrnutom smjeru.
Snažno se preporučuje da compareTo == 0 bude usklađen s equals; odstupanja dokumentirajte. Bez te usklađenosti uređeni skup može odbiti nejednak objekt kao duplikat. compareTo(null) baca NullPointerException; nekompatibilan tip može uzrokovati ClassCastException.
Primjer sortira Score pomoću Arrays.sort. Upotreba Integer.compare umjesto oduzimanja sprječava prekoračenje; jedino polje zapisa osigurava da je njegov poredak usklađen s equals.
Primjeri
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());
}
}
}Rezultat
10 20 30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.