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