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