CKTIS / Java
Integer.compare: comparar valores int e ordenar por ID
Utiliza `Integer.compare` para comparar dois valores `int` com sinal ou ordenar elementos por ID crescente sem depender de uma subtração que pode causar transbordo.
Versão: Java SE 21
Sintaxe
public static int compare(int x, int y)Integer.compare(x, y) é um método estático de java.lang.Integer, disponível desde o Java 7. Recebe dois valores primitivos int e compara-os como números com sinal. Devolve um valor negativo se x < y, 0 se x == y e um valor positivo se x > y. Não devolve a diferença. Testa o sinal do resultado em vez de presumires que um valor diferente de zero é exatamente -1 ou 1.
Para ordenar elementos por ID crescente, quando o ID é do tipo int, utiliza (a, b) -> Integer.compare(a.id(), b.id()) como comparador. Um resultado de 0 significa que os ID são iguais, não necessariamente que os objetos são iguais. Não substituas a chamada por a.id() - b.id(): a diferença pode ficar fora do intervalo de int e o transbordo pode produzir um sinal incorreto sem lançar uma exceção.
Integer.compareUnsigned(x, y) interpreta os mesmos bits como valores sem sinal. Já compareTo(Integer) é um método de instância da classe invólucro Integer e usa a ordem com sinal. Um argumento Integer passado a Integer.compare é convertido em int por unboxing; se for null, o unboxing lança NullPointerException antes da chamada ao método.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
record Item(int id) {}
public static void main(String[] args) {
int low = Integer.MIN_VALUE;
int high = 1;
System.out.println("compare < 0: " + (Integer.compare(low, high) < 0));
System.out.println("low - high: " + (low - high));
var items = new ArrayList<>(List.of(new Item(high), new Item(low), new Item(0)));
items.sort((a, b) -> Integer.compare(a.id(), b.id()));
System.out.println(items.stream().map(Item::id).toList());
}
}Resultado
compare < 0: true low - high: 2147483647 [-2147483648, 0, 1]
`Integer.MIN_VALUE` é menor do que `1`, por isso o teste `compare < 0` imprime `true`. A subtração sofre transbordo e produz o valor positivo `2147483647`, mas o comparador continua a ordenar os ID por ordem crescente.
Lições relacionadas
- Java · Lição 5 · Avançado · Versão: 2
- Java · Lição 5 · Intermédio · Versão: 2
Fontes
- Integer (Java SE 21 & JDK 21) — compare(int, int)
- Integer (Java SE 21 & JDK 21) — compareTo(Integer)
- Integer (Java SE 21 & JDK 21) — compareUnsigned(int, int)
- Comparator (Java SE 21 & JDK 21) — compare(T, T)
- List (Java SE 21 & JDK 21) — sort(Comparator)
- Java Language Specification, Java SE 21 — §15.18.2 Additive Operators (+ and -) for Numeric Types
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs