Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje