CKTIS / Java
Integer.compare : comparer des valeurs int et trier par identifiant
Utilisez `Integer.compare` pour comparer deux valeurs `int` signées ou trier des éléments par identifiant croissant sans risquer un dépassement de capacité dû à la soustraction.
Version : Java SE 21
Syntaxe
public static int compare(int x, int y)Integer.compare(x, y) est une méthode statique de java.lang.Integer, disponible depuis Java 7. Elle prend deux valeurs primitives de type int et les compare comme des nombres signés. Elle renvoie une valeur négative si x < y, 0 si x == y et une valeur positive si x > y. Elle ne renvoie pas la différence. Testez le signe du résultat sans supposer qu’une valeur non nulle vaut exactement -1 ou 1.
Pour trier des éléments par identifiant int croissant, utilisez (a, b) -> Integer.compare(a.id(), b.id()) comme comparateur. Un résultat de 0 indique que les identifiants sont égaux, pas nécessairement les objets. Ne remplacez pas cet appel par a.id() - b.id() : la différence peut sortir de la plage de int et le dépassement de capacité peut donner un signe erroné sans lever d’exception.
Integer.compareUnsigned(x, y) interprète les mêmes bits comme des valeurs non signées. En revanche, compareTo(Integer) est une méthode d’instance de la classe enveloppe Integer qui utilise l’ordre signé. Un argument Integer passé à Integer.compare est déballé en int ; s’il vaut null, le déballage lève une NullPointerException avant l’appel de la méthode.
Exemples
import java.util.ArrayList;
import java.util.List;
public class Main {
record Item(int id) {}
public static void main(String[] args) {
int low = Integer.MIN_VALUE;
int high = 1;
System.out.println("compare < 0: " + (Integer.compare(low, high) < 0));
System.out.println("low - high: " + (low - high));
var items = new ArrayList<>(List.of(new Item(high), new Item(low), new Item(0)));
items.sort((a, b) -> Integer.compare(a.id(), b.id()));
System.out.println(items.stream().map(Item::id).toList());
}
}Résultat
compare < 0: true low - high: 2147483647 [-2147483648, 0, 1]
`Integer.MIN_VALUE` est inférieur à `1`, donc le test `compare < 0` affiche `true`. La soustraction déborde et donne la valeur positive `2147483647`, mais le comparateur trie tout de même les identifiants dans l’ordre croissant.
Leçons associées
- Java · Leçon 5 · Avancé · Version : 2
- Java · Leçon 5 · Intermédiaire · Version : 2
Sources
- Integer (Java SE 21 & JDK 21) — compare(int, int)
- Integer (Java SE 21 & JDK 21) — compareTo(Integer)
- Integer (Java SE 21 & JDK 21) — compareUnsigned(int, int)
- Comparator (Java SE 21 & JDK 21) — compare(T, T)
- List (Java SE 21 & JDK 21) — sort(Comparator)
- Java Language Specification, Java SE 21 — §15.18.2 Additive Operators (+ and -) for Numeric Types
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs