KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Comparable — natuurlijke ordening van objecten

java.lang.Comparable<T> definieert de natuurlijke ordening van objecten via compareTo(T o). Het resultaat geeft de volgorde aan, niet de afstand tussen waarden.

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

Syntax

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

java.lang.Comparable<T> definieert een natuurlijke totale ordening. Comparable.compareTo, gedeclareerd als int compareTo(T o), geeft een negatieve waarde, nul of een positieve waarde terug als dit object respectievelijk kleiner, gelijkwaardig in de ordening of groter is dan het argument. Het teken is van belang, niet de exacte waarde -1 of 1.

Het contract vereist tegengestelde tekens wanneer de argumenten worden omgewisseld, transitiviteit en identieke vergelijkingstekens tegenover elk derde object voor objecten die als nul worden vergeleken. Een uitzondering in de ene richting vereist ook een uitzondering in de omgekeerde richting.

Het wordt sterk aanbevolen dat compareTo == 0 overeenkomt met equals; documenteer afwijkingen. Zonder die overeenkomst kan een gesorteerde verzameling een ongelijk object afwijzen als duplicaat. compareTo(null) veroorzaakt NullPointerException; een incompatibel type kan ClassCastException veroorzaken.

Het voorbeeld sorteert Score met Arrays.sort. Integer.compare gebruiken in plaats van aftrekken voorkomt overflow; het enkele veld van het record zorgt ervoor dat de ordening overeenkomt met equals.

Voorbeelden

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());
        }
    }
}

Resultaat

10
20
30

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen