CKTIS / Java
Comparable — naravno urejanje objektov
java.lang.Comparable<T> določa naravno urejanje objektov z metodo compareTo(T o). Rezultat pove vrstni red, ne razdalje med vrednostmi.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> določa naravni totalni vrstni red. Comparable.compareTo, deklarirana kot int compareTo(T o), vrne negativno vrednost, nič ali pozitivno vrednost, kadar je ta objekt glede na argument manjši, enakovreden v vrstnem redu ali večji. Pomemben je predznak, ne natančno -1 ali 1.
Pogodba zahteva nasprotna predznaka pri zamenjavi argumentov, tranzitivnost in enake predznake primerjave glede na vsak tretji objekt za objekte, ki se primerjajo kot nič. Izjema v eni smeri zahteva izjemo tudi v nasprotni smeri.
Močno se priporoča, da je compareTo == 0 skladen z equals; odstopanja dokumentirajte. Brez te skladnosti lahko urejena množica zavrne neenak objekt kot dvojnik. compareTo(null) sproži NullPointerException; nezdružljiv tip lahko povzroči ClassCastException.
Primer uredi Score z uporabo Arrays.sort. Uporaba Integer.compare namesto odštevanja prepreči prekoračitev; eno samo polje zapisa zagotavlja, da je njegov vrstni red skladen z equals.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.