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

CKTIS / Java

Comparable — ordenação natural de objetos

java.lang.Comparable<T> define a ordenação natural dos objetos através de compareTo(T o). O resultado indica a ordem, não a distância entre os valores.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public interface Comparable<T> {
    int compareTo(T o);
}

java.lang.Comparable<T> define uma ordenação total natural. Comparable.compareTo, declarado como int compareTo(T o), devolve um valor negativo, zero ou um valor positivo quando este objeto é, respetivamente, menor, equivalente na ordenação ou maior do que o argumento. O que importa é o sinal, não o valor exato -1 ou 1.

O contrato exige sinais opostos quando se invertem os argumentos, transitividade e sinais de comparação idênticos em relação a qualquer terceiro objeto quando dois objetos se comparam como zero. Uma exceção num sentido exige também uma exceção no sentido inverso.

Recomenda-se vivamente que compareTo == 0 seja coerente com equals; documente quaisquer diferenças. Sem essa coerência, um conjunto ordenado pode rejeitar um objeto diferente por o considerar duplicado. compareTo(null) lança NullPointerException; um tipo incompatível pode causar ClassCastException.

O exemplo ordena Score usando Arrays.sort. Usar Integer.compare em vez de subtrair evita o overflow; o campo único do record torna a sua ordenação coerente com equals.

Exemplos

import java.util.Arrays;

public class Main {
    record Score(int points) implements Comparable<Score> {
        @Override
        public int compareTo(Score other) {
            return Integer.compare(points, other.points);
        }
    }

    public static void main(String[] args) {
        Score[] scores = {new Score(30), new Score(10), new Score(20)};
        Arrays.sort(scores);
        for (Score score : scores) {
            System.out.println(score.points());
        }
    }
}

Resultado

10
20
30

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes