Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

BigDecimal.compareTo — porównywanie wartości dziesiętnych

`BigDecimal.compareTo` porównuje wartości liczbowe bez uwzględniania różnic w skali. Wynik porównaj z zerem, aby sprawdzić kolejność lub równość liczbową.

Wersja: Java SE 21

Składnia

public int compareTo(BigDecimal val)

// If x and y are BigDecimal values:
x.compareTo(y) < 0   // x is numerically less than y
x.compareTo(y) == 0  // x and y are numerically equal
x.compareTo(y) > 0   // x is numerically greater than y

W Java SE 21 metoda instancyjna compareTo(BigDecimal val) klasy java.math.BigDecimal implementuje kontrakt Comparable<BigDecimal>. Przyjmuje jeden argument typu BigDecimal; nie ma przeciążenia przyjmującego bezpośrednio double ani String. Przekazanie null powoduje NullPointerException.

Wywołanie x.compareTo(y) zwraca wartość typu int: -1, gdy x jest liczbowo mniejsze od y, 0, gdy wartości są równe, lub 1, gdy x jest większe. Porównuj wynik z zerem, np. x.compareTo(y) < 0 lub x.compareTo(y) == 0. To nie jest różnica liczb. Ogólny kontrakt Comparable określa tylko znak wyniku; te trzy konkretne wartości gwarantuje BigDecimal.

Porównanie nie zaokrągla wartości ani nie zmienia żadnego z obiektów. 2.0 i 2.00 mają tę samą wartość liczbową, więc compareTo zwraca 0. Mają jednak różne skale (1 i 2), więc equals(Object) zwraca false: wymaga zgodności zarówno wartości, jak i skali.

Operator == użyty bezpośrednio na dwóch referencjach typu BigDecimal zwraca true, gdy obie wskazują ten sam obiekt lub obie mają wartość null. Nie porównuje wartości liczbowych. Ponieważ porządek naturalny różni się od equals, TreeSet<BigDecimal> bez własnego komparatora traktuje 2.0 i 2.00 jako jeden element.

Przykłady

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        BigDecimal a = new BigDecimal("2.0");
        BigDecimal b = new BigDecimal("2.00");
        BigDecimal c = new BigDecimal("3.0");

        System.out.println(a.compareTo(b));
        System.out.println(a.equals(b));
        System.out.println(a.compareTo(c));
        System.out.println(c.compareTo(a));
    }
}

Wynik

0
false
-1
1

Argumenty tekstowe konstruktora zachowują skale `1` i `2` dla `a` i `b`. Pierwsze dwa wiersze pokazują różnicę między porównaniem liczbowym a `equals`; ostatnie dwa pokazują, jak zamiana kolejności argumentów porównania zmienia znak wyniku.

Powiązane lekcje

  • Java · Lekcja 69 · Podstawowy · Wersja: 2

Źródła