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

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