CKTIS / Java
Comparable.compareTo(): naravna urejenost v Javi
Primerjaj objekte po njihovi naravni urejenosti. Preberi predznak rezultata, loči enak položaj v vrstnem redu od enakosti po equals in izberi, kateri objekt ob izenačenju obdržati.
Različica: Java SE 21
Sintaksa
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 metodo primerka int compareTo(T other) iz vmesnika java.lang.Comparable<T>. Klic a.compareTo(b) sprejme en argument in primerja a z b po njuni naravni urejenosti. Rezultat < 0 pomeni, da je a pred b, == 0 pomeni izenačenje, > 0 pa, da je a za b. Ne predpostavljaj, da je rezultat natanko -1 ali 1. Za drugačno urejenost uporabi Comparator<T> in pokliči compare(a, b).
Zamenjava operandov mora obrniti predznak, urejenost mora biti tranzitivna, izenačena objekta pa morata pri primerjavi s poljubnim tretjim primerljivim objektom dati enak predznak. V hierarhiji razredov za primerke osnovnega in izpeljanih razredov uporabi skupna pravila urejanja, če so primerljivi med seboj. Polja tipa int primerjaj z Integer.compare(x, y) in ne z x - y, saj lahko pri odštevanju pride do prekoračitve obsega. Argument null povzroči NullPointerException; argument, katerega tip onemogoča primerjavo, povzroči ClassCastException.
Skladnost z equals je močno priporočljiva, ni pa obvezna: a.compareTo(b) == 0 in a.equals(b) naj vrneta enak logični rezultat. Morebitno odstopanje dokumentiraj. Na primer, vrednosti BigDecimal 2.00 in 2.0 sta po naravni urejenosti izenačeni, vendar equals vrne false, ker imata različno lestvico. TreeSet brez primerjalnika ju obravnava kot isti element.
Generična omejitev <T extends Comparable<? super T>> omogoča primerjavo vrednosti tipa T, tudi če T podeduje Comparable za nadtip. Pri iskanju minimuma ali maksimuma trenutni izbor zamenjaj le, če je novi element strogo manjši (< 0) oziroma večji (> 0). Tako ob izenačenju obdržiš prvi element. Pri dveh argumentih a.compareTo(b) <= 0 ob izenačenju izbere a.
Pred omejevanjem vrednosti na interval (clamp) preveri min.compareTo(max) <= 0. Pod intervalom vrni min, nad njim max, sicer pa izvirno vrednost, tudi če se pri primerjavi izenači s katero od mej.
Primeri
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));
}
}Rezultat
a < high: true a compares equal to b: true a.equals(b): false min: 2.00 clamp: 3
`a` in `b` imata enako številsko vrednost, vendar različno lestvico. `min(a, b)` obdrži prvi argument, zato se izpiše `2.00`. `clamp` vrne zgornjo mejo `3`, ker jo `4` presega.
Povezane lekcije
- Java · Lekcija 5 · Napredna · Različica: 2
- Java · Lekcija 11 · Napredna · Različica: 2
- Java · Lekcija 15 · Napredna · Različica: 2
- Java · Lekcija 48 · Osnovna · Različica: 2
- Java · Lekcija 5 · Srednja · Različica: 2