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

CKTIS / Java

Comparator.comparingInt : comparer selon une clé int

Créez un comparateur qui ordonne des objets par valeur croissante d’une clé `int`, sans convertir cette clé en `Integer` (boxing).

Version : Java SE 21

Syntaxe

static <T> Comparator<T> comparingInt(ToIntFunction<? super T> keyExtractor)

Comparator.comparingInt est une méthode de fabrique statique de l’interface java.util.Comparator, disponible depuis Java 8 et présente dans Java SE 21. La notation Comparator.comparingInt() désigne ici la méthode, mais ce n’est pas un appel valide : il n’existe aucune surcharge sans argument. La méthode prend une fonction d’extraction de clé (ToIntFunction<? super T>) et renvoie un Comparator<T> ; elle ne trie rien elle-même.

Dans Comparator.comparingInt(Person::age), la référence de méthode lit l’âge de type int de chaque objet Person comparé. Le comparateur ordonne les clés par valeur numérique croissante. Contrairement à Comparator.comparing(Person::age), cette forme ne nécessite pas de boxing de la clé en Integer.

À clés égales, compare(a, b) renvoie 0 même si a.equals(b) renvoie false. Le tri stable de List.sort conserve l’ordre relatif de ces éléments. Utilisez reversed() pour inverser l’ordre ou thenComparingInt(...) pour départager les éléments avec une deuxième clé int.

Passer null à la place de la fonction d’extraction déclenche une NullPointerException. C’est différent d’un élément null, que Comparator.nullsLast(byAge) permet de placer en dernier. Une clé int ne peut pas valoir null ; convertir un Integer valant null en int (unboxing) déclenche aussi une NullPointerException. Le comparateur renvoyé est sérialisable si la fonction fournie l’est.

Exemples

import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;

public class Main {
    record Person(String name, int age) {}

    public static void main(String[] args) {
        var people = new ArrayList<>(List.of(
                new Person("Mira", 30),
                new Person("Tomas", 19),
                new Person("Ada", 19)
        ));

        Comparator<Person> byAge = Comparator.comparingInt(Person::age);
        people.sort(byAge);

        for (Person person : people) {
            System.out.println(person.name() + ": " + person.age());
        }
    }
}

Résultat

Tomas: 19
Ada: 19
Mira: 30

`Person::age` extrait la clé. `people.sort(byAge)` trie la liste modifiable sur place. Tomas reste devant Ada : ils ont tous les deux 19 ans et figuraient dans cet ordre dans la liste initiale.

Leçons associées

  • Java · Leçon 8 · Avancé · Version : 2
  • Java · Leçon 61 · Débutant · Version : 2

Sources