База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Comparable.compareTo(): естествен ред в Java

Сравнявай обекти според естествения им ред. Разчитай знака на резултата, различавай равенството при подреждане от това според equals и избирай кой обект да запазиш.

Версия: Java SE 21

Синтаксис

Java SE 21 — java.lang.Comparable<T>
Interface method: int compareTo(T other);
Call: int result = a.compareTo(b);
Implementation signature for MyType implements Comparable<MyType>: @Override public int compareTo(MyType other)
Generic bound for natural-order helpers: <T extends Comparable<? super T>>

Comparable.compareTo() означава метода на екземпляр int compareTo(T other) от интерфейса java.lang.Comparable<T>. Извикването a.compareTo(b) приема един аргумент и сравнява a с b според естествения им ред. Резултат < 0 означава, че a е преди b, == 0 означава равенство в реда, а > 0 означава, че a е след b. Не приемай, че резултатът е точно -1 или 1. За друг ред използвай Comparator<T> и извикай compare(a, b).

Размяната на операндите трябва да обръща знака, редът трябва да е транзитивен, а два равни по ред обекта трябва да дават един и същ знак при сравнение с произволен трети сравним обект. В йерархия от класове използвай общи правила за подреждане на екземплярите на базовия и производните класове, ако могат да се сравняват помежду си. За полета от тип int използвай Integer.compare(x, y), а не x - y, защото изваждането може да доведе до препълване. Аргумент null предизвиква NullPointerException, а аргумент с тип, който не позволява сравнение — ClassCastException.

Съгласуваността с equals е силно препоръчителна, но не е задължителна: a.compareTo(b) == 0 и a.equals(b) би трябвало да дават един и същ булев резултат. Документирай всяко отклонение. Например стойностите BigDecimal 2.00 и 2.0 са равни в естествения ред, но equals връща false, защото имат различен мащаб. TreeSet без компаратор ги третира като един и същ елемент.

Ограничението на типовия параметър <T extends Comparable<? super T>> позволява да сравняваш стойности от тип T дори когато T наследява Comparable за супертип. При търсене на минимум или максимум замени текущия избор само ако новият елемент е строго по-малък (< 0), съответно строго по-голям (> 0). Така при равенство остава първият елемент. При два аргумента a.compareTo(b) <= 0 избира a при равенство.

Преди да ограничиш стойност до интервал (clamp), провери min.compareTo(max) <= 0. Върни min под интервала, max над него, а в останалите случаи — първоначалната стойност, включително когато е равна по ред на някоя от границите.

Примери

import java.math.BigDecimal;

public class Main {
    static <T extends Comparable<? super T>> T min(T a, T b) {
        return a.compareTo(b) <= 0 ? a : b;
    }

    static <T extends Comparable<? super T>> T clamp(T value, T min, T max) {
        if (min.compareTo(max) > 0) {
            throw new IllegalArgumentException("min > max");
        }
        if (value.compareTo(min) < 0) return min;
        if (value.compareTo(max) > 0) return max;
        return value;
    }

    public static void main(String[] args) {
        BigDecimal a = new BigDecimal("2.00");
        BigDecimal b = new BigDecimal("2.0");
        BigDecimal high = new BigDecimal("3");

        System.out.println("a < high: " + (a.compareTo(high) < 0));
        System.out.println("a compares equal to b: " + (a.compareTo(b) == 0));
        System.out.println("a.equals(b): " + a.equals(b));
        System.out.println("min: " + min(a, b));
        System.out.println("clamp: " + clamp(new BigDecimal("4"), a, high));
    }
}

Резултат

a < high: true
a compares equal to b: true
a.equals(b): false
min: 2.00
clamp: 3

`a` и `b` имат еднаква числова стойност, но различен мащаб. `min(a, b)` запазва първия аргумент, затова се извежда `2.00`. `clamp` връща горната граница `3`, защото `4` я надхвърля.

Свързани уроци

  • Java · Урок 5 · Напреднало · Версия: 2
  • Java · Урок 11 · Напреднало · Версия: 2
  • Java · Урок 15 · Напреднало · Версия: 2
  • Java · Урок 48 · Начално · Версия: 2
  • Java · Урок 5 · Средно · Версия: 2

Източници