База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

BigDecimal.compareTo — Сравняване на десетични стойности

`BigDecimal.compareTo` сравнява числови стойности, без да отчита разликите в мащаба. Сравнете резултата с нула, за да проверите реда или числовото равенство.

Версия: Java SE 21

Синтаксис

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

В Java SE 21 методът compareTo(BigDecimal val) на java.math.BigDecimal се извиква върху обект и изпълнява договора на Comparable<BigDecimal>. Приема един аргумент от тип BigDecimal; няма претоварена версия, която да приема директно double или String. Подаването на null предизвиква NullPointerException.

x.compareTo(y) връща стойност от тип int: -1, ако x е числово по-малко от y, 0, ако стойностите са равни, или 1, ако x е по-голямо. Сравнете резултата с нула, например чрез x.compareTo(y) < 0 или x.compareTo(y) == 0. Резултатът не е разликата между числата. Общият договор на Comparable определя само знака; BigDecimal гарантира тези три точни стойности.

Сравнението не закръгля стойностите и не променя обектите. 2.0 и 2.00 имат една и съща числова стойност, затова compareTo връща 0. Мащабите им обаче са различни (1 и 2), затова equals(Object) връща false: трябва да съвпадат и стойността, и мащабът.

Операторът ==, приложен директно към две референции от тип BigDecimal, дава true, ако сочат към един и същ обект или ако и двете са null. Той не сравнява числовите стойности. Тъй като естествената наредба се различава от equals, TreeSet<BigDecimal> без собствен компаратор третира 2.0 и 2.00 като един елемент.

Примери

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));
    }
}

Резултат

0
false
-1
1

Низовете, подадени на конструктора, запазват мащабите `1` и `2` за `a` и `b`. Първите два реда показват разликата между числовото сравнение и `equals`, а последните два показват, че размяната на операндите променя знака.

Свързани уроци

  • Java · Урок 69 · Начално · Версия: 2

Източници