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

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