Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Comparator.comparingInt: comparar por uma chave int

Cria um comparador que ordena objetos por valor crescente de uma chave `int`, sem converter a chave num `Integer` por boxing.

Versão: Java SE 21

Sintaxe

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

Comparator.comparingInt é um método de fábrica estático da interface java.util.Comparator, disponível desde Java 8 e presente em Java SE 21. A notação Comparator.comparingInt() identifica aqui o método, mas não é uma chamada válida: não existe uma sobrecarga sem argumentos. O método recebe uma função de extração da chave (ToIntFunction<? super T>) e devolve um Comparator<T>; não ordena nada por si só.

Em Comparator.comparingInt(Person::age), a referência ao método lê a idade de tipo int de cada objeto Person comparado. O comparador ordena as chaves numericamente, da menor para a maior. Ao contrário de Comparator.comparing(Person::age), esta forma não exige boxing da chave para Integer.

Quando as chaves são iguais, compare(a, b) devolve 0 mesmo que a.equals(b) devolva false. A ordenação estável de List.sort mantém a ordem relativa desses elementos. Usa reversed() para inverter a ordem ou thenComparingInt(...) para desempatar com uma segunda chave int.

Passar null como função de extração lança uma NullPointerException. É diferente de ter um elemento null, que podes colocar no fim com Comparator.nullsLast(byAge). Uma chave int não pode ser null; fazer unboxing de um Integer com o valor null também lança uma NullPointerException. O comparador devolvido é serializável se a função fornecida também o for.

Exemplos

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

Resultado

Tomas: 19
Ada: 19
Mira: 30

`Person::age` extrai a chave. `people.sort(byAge)` ordena diretamente a lista modificável. Tomas continua antes de Ada porque ambos têm 19 anos e apareciam nessa ordem na lista inicial.

Lições relacionadas

  • Java · Lição 8 · Avançado · Versão: 2
  • Java · Lição 61 · Básico · Versão: 2

Fontes