CKTIS / Java
BigDecimal.add — somma esatta o arrotondata
Somma valori BigDecimal senza arrotondare oppure usa MathContext per impostare la precisione e la modalità di arrotondamento del risultato.
Versione: Java SE 21
Sintassi
import java.math.BigDecimal;
import java.math.MathContext;
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
// Instance method signatures in java.math.BigDecimal:
// public BigDecimal add(BigDecimal augend)
// public BigDecimal add(BigDecimal augend, MathContext mc)BigDecimal.add è un metodo di istanza di java.math.BigDecimal. In a.add(b), l’oggetto a e l’argomento b sono i due addendi. Non si possono sommare due oggetti BigDecimal con +. Questi oggetti sono immutabili: il metodo restituisce il risultato senza modificare gli addendi. Salva o usa il valore restituito; la sola istruzione a.add(b); non aggiorna a.
a.add(b) restituisce la somma esatta con scala max(a.scale(), b.scale()). Una scala non negativa indica il numero di cifre dopo il separatore decimale, compresi gli zeri finali. La scala può anche essere negativa: con scala -2, il valore è l’intero memorizzato moltiplicato per 100.
a.add(b, mc) accetta un MathContext di java.math. Una precisione positiva limita il numero di cifre significative del risultato, non il numero di decimali. Il metodo arrotonda la somma esatta se necessario secondo la modalità del contesto, quindi la scala può cambiare. Con precisione positiva, se uno solo dei due addendi è zero, il risultato ha il valore numerico dell’addendo non nullo, arrotondato se necessario. La scala del risultato può differire da quella dell’addendo non nullo anche quando non occorre arrotondare. Per esempio, sommando 0.00 a 1 con precisione 3 si ottiene 1.00. Una precisione pari a 0, come in MathContext.UNLIMITED, indica una somma senza arrotondamento.
Se l’arrotondamento cambierebbe il valore, RoundingMode.UNNECESSARY provoca una ArithmeticException. Passare null come b o mc provoca una NullPointerException.
Esempi
import java.math.BigDecimal;
import java.math.MathContext;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal a = new BigDecimal("12.40");
BigDecimal b = new BigDecimal("0.350");
MathContext mc = new MathContext(3, RoundingMode.HALF_UP);
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
System.out.println(exact.toPlainString());
System.out.println(rounded.toPlainString());
System.out.println(a.toPlainString());
}
}Risultato
12.750 12.8 12.40
Gli addendi sono costruiti a partire da stringhe per evitare una conversione preliminare in `double`. La somma esatta `12.750` ha scala 3; con tre cifre significative, `HALF_UP` dà `12.8`. L’ultima riga mostra che `a` vale ancora `12.40`.
Lezioni correlate
- Java · Lezione 4 · Base · Versione: 2
- Java · Lezione 69 · Base · Versione: 2