CKTIS / Java
BigDecimal.compareTo — Porovnávání desetinných hodnot
`BigDecimal.compareTo` porovnává číselné hodnoty bez ohledu na rozdíly v měřítku. Porovnáním výsledku s nulou zjistíte pořadí nebo číselnou rovnost.
Verze: Java SE 21
Syntaxe
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 yV Java SE 21 implementuje instanční metoda compareTo(BigDecimal val) třídy java.math.BigDecimal kontrakt rozhraní Comparable<BigDecimal>. Přijímá jeden argument typu BigDecimal; neexistuje přetížení, které by přímo přijímalo double nebo String. Předání null vyvolá výjimku NullPointerException.
Volání x.compareTo(y) vrací hodnotu typu int: -1, pokud je x číselně menší než y, 0, pokud jsou hodnoty stejné, nebo 1, pokud je x větší. Porovnejte výsledek s nulou, například pomocí x.compareTo(y) < 0 nebo x.compareTo(y) == 0. Výsledek není rozdíl těchto čísel. Obecný kontrakt Comparable určuje pouze znaménko; BigDecimal zaručuje tyto tři přesné návratové hodnoty.
Porovnání hodnoty nezaokrouhluje ani nemění žádný z objektů. 2.0 a 2.00 mají stejnou číselnou hodnotu, proto compareTo vrátí 0. Mají ale různá měřítka (1 a 2), takže equals(Object) vrátí false: vyžaduje shodu hodnoty i měřítka.
Operátor == použitý přímo na dvou referencích typu BigDecimal vrací true, pokud odkazují na tentýž objekt nebo pokud jsou obě null. Číselné hodnoty neporovnává. Protože se přirozené uspořádání liší od equals, TreeSet<BigDecimal> bez vlastního komparátoru považuje 2.0 a 2.00 za jediný prvek.
Příklady
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));
}
}
Výsledek
0 false -1 1
Řetězce předané konstruktoru zachovávají měřítka `1` a `2` u `a` a `b`. První dva řádky ukazují rozdíl mezi číselným porovnáním a `equals`; poslední dva ukazují, že záměna operandů změní znaménko.
Související lekce
- Java · Lekce 69 · Základní · Verze: 2