Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori