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.