CKTIS / Java
BigDecimal.compareTo — Confrontare valori decimali
`BigDecimal.compareTo` confronta i valori numerici senza tener conto delle differenze di scala. Confronta il risultato con zero per verificare l’ordine o l’uguaglianza numerica.
Versione: Java SE 21
Sintassi
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 yIn Java SE 21, il metodo di istanza compareTo(BigDecimal val) di java.math.BigDecimal implementa il contratto di Comparable<BigDecimal>. Accetta un argomento di tipo BigDecimal; non esiste un overload che accetti direttamente un double o una String. Passare null provoca una NullPointerException.
x.compareTo(y) restituisce un int: -1 se x è numericamente minore di y, 0 se i valori sono uguali o 1 se x è maggiore. Confronta il risultato con zero, per esempio con x.compareTo(y) < 0 o x.compareTo(y) == 0. Il risultato non è la differenza tra i numeri. Il contratto generale di Comparable specifica solo il segno; BigDecimal garantisce questi tre valori esatti.
Il confronto non arrotonda i valori né modifica gli oggetti. 2.0 e 2.00 hanno lo stesso valore numerico, quindi compareTo restituisce 0. Hanno però scale diverse (1 e 2), quindi equals(Object) restituisce false: richiede che coincidano sia il valore sia la scala.
Applicato direttamente a due riferimenti BigDecimal, == dà true se indicano lo stesso oggetto o se entrambi sono null. Non confronta i valori numerici. Poiché l’ordinamento naturale differisce da equals, un TreeSet<BigDecimal> senza un comparatore personalizzato considera 2.0 e 2.00 un unico elemento.
Esempi
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));
}
}
Risultato
0 false -1 1
Le stringhe passate al costruttore mantengono le scale `1` e `2` di `a` e `b`. Le prime due righe mettono a confronto il confronto numerico e `equals`; le ultime due mostrano che scambiare gli operandi cambia il segno.
Lezioni correlate
- Java · Lezione 69 · Base · Versione: 2