Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri