Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Comparable.compareTo(): prirodni poredak u Javi

Uspoređuj objekte prema prirodnom poretku. Protumači predznak rezultata, razlikuj isti položaj u poretku od jednakosti prema equals i odaberi koji objekt zadržati.

Verzija: 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čava metodu instance int compareTo(T other) iz sučelja java.lang.Comparable<T>. Poziv a.compareTo(b) prima jedan argument i uspoređuje a s b prema njihovu prirodnom poretku. Rezultat < 0 znači da je a ispred b, == 0 znači da su izjednačeni, a > 0 znači da je a iza b. Nemoj pretpostaviti da je rezultat točno -1 ili 1. Za drukčiji poredak upotrijebi Comparator<T> i pozovi compare(a, b).

Zamjena operanada mora obrnuti predznak, poredak mora biti tranzitivan, a izjednačeni objekti moraju dati isti predznak pri usporedbi s bilo kojim trećim usporedivim objektom. U hijerarhiji klasa primijeni zajednička pravila poretka na instance osnovne i izvedenih klasa ako se one mogu međusobno uspoređivati. Za polja tipa int upotrijebi Integer.compare(x, y), a ne x - y, jer oduzimanje može prekoračiti raspon. Argument null uzrokuje NullPointerException; argument čiji tip onemogućuje usporedbu uzrokuje ClassCastException.

Dosljednost s equals snažno se preporučuje, ali nije obvezna: a.compareTo(b) == 0 i a.equals(b) trebali bi dati isti logički rezultat. Dokumentiraj svako odstupanje. Primjerice, vrijednosti BigDecimal 2.00 i 2.0 izjednačene su u prirodnom poretku, ali equals vraća false jer im se skale razlikuju. TreeSet bez komparatora tretira ih kao isti element.

Generičko ograničenje <T extends Comparable<? super T>> omogućuje usporedbu vrijednosti tipa T čak i kad T nasljeđuje Comparable za nadtip. Pri traženju minimuma ili maksimuma zamijeni trenutni izbor samo ako je novi element strogo manji (< 0), odnosno veći (> 0). Tako u slučaju izjednačenja zadržavaš prvi element. Za dva argumenta a.compareTo(b) <= 0 odabire a kad su izjednačeni.

Prije ograničavanja vrijednosti na interval (clamp), provjeri min.compareTo(max) <= 0. Ispod intervala vrati min, iznad njega max, a inače izvornu vrijednost, čak i kad je u poretku izjednačena s jednom od granica.

Primjeri

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` i `b` brojčano su jednaki, ali imaju različite skale. `min(a, b)` zadržava prvi argument pa se ispisuje `2.00`. `clamp` vraća gornju granicu `3` jer je `4` iznad nje.

Povezane lekcije

  • Java · Lekcija 5 · Napredno · Verzija: 2
  • Java · Lekcija 11 · Napredno · Verzija: 2
  • Java · Lekcija 15 · Napredno · Verzija: 2
  • Java · Lekcija 48 · Osnovno · Verzija: 2
  • Java · Lekcija 5 · Srednje · Verzija: 2

Izvori