Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Comparable — přirozené uspořádání objektů

java.lang.Comparable<T> definuje přirozené uspořádání objektů pomocí compareTo(T o). Výsledek určuje pořadí, nikoli vzdálenost mezi hodnotami.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public interface Comparable<T> {
    int compareTo(T o);
}

java.lang.Comparable<T> definuje přirozené úplné uspořádání. Comparable.compareTo, deklarovaná jako int compareTo(T o), vrací zápornou hodnotu, nulu nebo kladnou hodnotu, pokud je tento objekt vzhledem k argumentu menší, rovnocenný v uspořádání, nebo větší. Rozhoduje znaménko, nikoli přesně -1 nebo 1.

Kontrakt vyžaduje opačná znaménka při prohození argumentů, tranzitivitu a stejná znaménka porovnání vůči každému třetímu objektu pro objekty, které se porovnávají jako nula. Výjimka v jednom směru vyžaduje výjimku také v opačném směru.

Důrazně se doporučuje, aby compareTo == 0 odpovídalo equals; případné odchylky zdokumentujte. Bez této shody může uspořádaná množina odmítnout nerovný objekt jako duplicitu. compareTo(null) vyvolá NullPointerException; nekompatibilní typ může způsobit ClassCastException.

Příklad řadí Score pomocí Arrays.sort. Použití Integer.compare místo odčítání zabraňuje přetečení; jediné pole recordu zajišťuje, že jeho uspořádání odpovídá equals.

Pří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ýsledek

10
20
30

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje