Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 y

In 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

Fonti