Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Comparator.comparingInt: confrontare per chiave int

Crea un comparatore che ordina gli oggetti per valore crescente di una chiave `int`, senza eseguire il boxing della chiave in un `Integer`.

Versione: Java SE 21

Sintassi

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

Comparator.comparingInt è un metodo factory statico dell’interfaccia java.util.Comparator, disponibile da Java 8 e presente in Java SE 21. La notazione Comparator.comparingInt() indica qui il metodo, ma non è una chiamata valida: non esiste un overload senza argomenti. Il metodo accetta una funzione di estrazione della chiave (ToIntFunction<? super T>) e restituisce un Comparator<T>; non ordina nulla da solo.

In Comparator.comparingInt(Person::age), il riferimento al metodo legge l’età di tipo int di ogni oggetto Person confrontato. Il comparatore ordina le chiavi numericamente, dalla più piccola alla più grande. A differenza di Comparator.comparing(Person::age), questa forma non richiede il boxing della chiave in Integer.

A parità di chiave, compare(a, b) restituisce 0 anche se a.equals(b) restituisce false. L’ordinamento stabile di List.sort conserva l’ordine relativo di questi elementi. Usa reversed() per invertire l’ordine o thenComparingInt(...) per risolvere i pareggi con una seconda chiave int.

Passare null come funzione di estrazione causa una NullPointerException. È un caso diverso da un elemento null, che puoi mettere in fondo con Comparator.nullsLast(byAge). Una chiave int non può essere null; anche l’unboxing di un Integer che vale null causa una NullPointerException. Il comparatore restituito è serializzabile se lo è la funzione fornita.

Esempi

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());
        }
    }
}

Risultato

Tomas: 19
Ada: 19
Mira: 30

`Person::age` estrae la chiave. `people.sort(byAge)` ordina la lista modificabile sul posto. Tomas rimane prima di Ada perché entrambi hanno 19 anni e comparivano in quest’ordine nella lista iniziale.

Lezioni correlate

  • Java · Lezione 8 · Avanzato · Versione: 2
  • Java · Lezione 61 · Base · Versione: 2

Fonti