CKTIS / Java
Comparable.compareTo(): prirodzené usporiadanie v Jave
Porovnávajte objekty podľa prirodzeného usporiadania. Vyhodnoťte znamienko výsledku, odlíšte zhodu v poradí od rovnosti podľa equals a rozhodnite, ktorý objekt pri zhode ponechať.
Verzia: Java SE 21
Syntax
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() označuje inštančnú metódu int compareTo(T other) rozhrania java.lang.Comparable<T>. Volanie a.compareTo(b) prijíma jeden argument a porovnáva a s b podľa ich prirodzeného usporiadania. Výsledok < 0 znamená, že a je pred b, == 0 znamená zhodu v poradí a > 0 znamená, že a je za b. Nespoliehajte sa na to, že výsledkom je presne -1 alebo 1. Pre iné usporiadanie použite Comparator<T> a zavolajte compare(a, b).
Zámena operandov musí obrátiť znamienko, usporiadanie musí byť tranzitívne a objekty so zhodným poradím musia pri porovnaní s ľubovoľným tretím porovnateľným objektom dávať rovnaké znamienko. V hierarchii tried používajte spoločné pravidlá pre inštancie základnej a odvodených tried, ak sa dajú navzájom porovnávať. Polia typu int porovnávajte pomocou Integer.compare(x, y), nie pomocou x - y, pretože odčítanie môže pretiecť. Argument null vyvolá NullPointerException; argument, ktorého typ znemožňuje porovnanie, vyvolá ClassCastException.
Súlad s equals sa dôrazne odporúča, ale nie je povinný: a.compareTo(b) == 0 a a.equals(b) by mali dať rovnaký logický výsledok. Prípadnú odchýlku zdokumentujte. Napríklad hodnoty BigDecimal 2.00 a 2.0 majú v prirodzenom usporiadaní zhodné poradie, ale equals vráti false, pretože majú rozdielnu škálu. TreeSet bez komparátora ich považuje za ten istý prvok.
Generické obmedzenie <T extends Comparable<? super T>> umožňuje porovnávať hodnoty typu T, aj keď T dedí Comparable pre nadtyp. Pri hľadaní minima alebo maxima nahraďte doterajší prvok len vtedy, keď je nový prvok striktne menší (< 0), respektíve väčší (> 0). Pri zhode tak zostane prvý prvok. Pri dvoch argumentoch podmienka a.compareTo(b) <= 0 pri zhode vyberie a.
Pred obmedzením hodnoty na interval (clamp) overte min.compareTo(max) <= 0. Pod intervalom vráťte min, nad ním max, inak pôvodnú hodnotu, aj keď sa v poradí zhoduje s jednou z hraníc.
Príklady
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));
}
}Výsledok
a < high: true a compares equal to b: true a.equals(b): false min: 2.00 clamp: 3
`a` a `b` majú rovnakú číselnú hodnotu, ale rozdielnu škálu. `min(a, b)` ponechá prvý argument, takže sa vypíše `2.00`. `clamp` vráti hornú hranicu `3`, pretože ju `4` prekračuje.
Súvisiace lekcie
- Java · Lekcia 5 · Pokročilá · Verzia: 2
- Java · Lekcia 11 · Pokročilá · Verzia: 2
- Java · Lekcia 15 · Pokročilá · Verzia: 2
- Java · Lekcia 48 · Základná · Verzia: 2
- Java · Lekcia 5 · Stredne pokročilá · Verzia: 2