Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Comparable — ordre naturel des objets

java.lang.Comparable<T> définit l’ordre naturel des objets au moyen de compareTo(T o). Le résultat indique l’ordre, et non la distance entre les valeurs.

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

Syntaxe

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

java.lang.Comparable<T> définit un ordre total naturel. Comparable.compareTo, déclaré sous la forme int compareTo(T o), renvoie une valeur négative, zéro ou une valeur positive lorsque cet objet est respectivement inférieur, équivalent dans l’ordre ou supérieur à l’argument. C’est le signe qui compte, et non la valeur exacte -1 ou 1.

Le contrat exige des signes opposés lorsque les arguments sont inversés, la transitivité et des signes de comparaison identiques avec tout troisième objet lorsque deux objets se comparent à zéro. Une exception dans un sens implique aussi une exception dans le sens inverse.

Il est fortement recommandé que compareTo == 0 soit cohérent avec equals ; toute différence doit être documentée. Sans cette cohérence, un ensemble trié peut rejeter un objet différent en le considérant comme un doublon. compareTo(null) déclenche NullPointerException ; un type incompatible peut provoquer ClassCastException.

L’exemple trie Score avec Arrays.sort. Utiliser Integer.compare plutôt qu’une soustraction évite les dépassements de capacité ; le champ unique du record rend son ordre cohérent avec equals.

Exemples

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

Résultat

10
20
30

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources