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

CKTIS / Java

Comparator.thenComparingInt() : ajouter une clé de tri secondaire de type int

Ajoutez une clé de type `int` en ordre croissant à un comparateur existant. Cette clé ne détermine l’ordre que si le comparateur initial renvoie `0`.

Version : Java SE 21

Syntaxe

default Comparator<T> thenComparingInt(ToIntFunction<? super T> keyExtractor)

Comparator.thenComparingInt() est une méthode par défaut de l’interface java.util.Comparator, disponible depuis Java 8. Elle renvoie un comparateur composé. Si le comparateur initial renvoie une valeur différente de 0, ce résultat fixe l’ordre. Le nouveau comparateur ne compare les clés int en ordre croissant que si le premier résultat vaut 0. Des clés identiques donnent 0, sans pour autant rendre les objets égaux au sens de equals().

L’argument ToIntFunction<? super T> est une fonction dont le type d’entrée peut être T ou un supertype de T, et qui renvoie un int primitif. Passez une référence de méthode comme Task::priority ou une expression lambda comme task -> task.priority(). Contrairement à thenComparing avec une fonction qui extrait une clé Comparable, cette méthode ne nécessite pas d’encapsuler la clé dans un Integer.

Utilisez la méthode statique Comparator.comparingInt(...) lorsque la clé numérique doit être le premier critère. Appelez thenComparingInt(...) sur un comparateur existant lorsque le nombre ne doit servir qu’à départager les ex æquo. Passer null comme fonction d’extraction déclenche une NullPointerException.

Exemples

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

public class Main {
    record Task(String team, int priority) {}

    public static void main(String[] args) {
        var tasks = new ArrayList<>(List.of(
                new Task("Ops", 3),
                new Task("Dev", 4),
                new Task("Ops", 1),
                new Task("Dev", 2)
        ));

        Comparator<Task> order = Comparator.comparing(Task::team)
                .thenComparingInt(Task::priority);

        tasks.sort(order);
        for (Task task : tasks) {
            System.out.println(task.team() + " " + task.priority());
        }
    }
}

Résultat

Dev 2
Dev 4
Ops 1
Ops 3

Le nom de l’équipe est comparé en premier. L’ordre croissant des priorités ne s’applique qu’au sein d’une même équipe. Ainsi, `Dev 4` précède `Ops 1`, bien que `4` soit supérieur à `1`.

Leçons associées

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

Sources