CKTIS / Java
Moltiplicare numeri decimali con BigDecimal.multiply
Moltiplica due valori `BigDecimal` esattamente oppure arrotonda il prodotto secondo la precisione e la modalità di arrotondamento di un `MathContext`.
Versione: Java SE 21
Sintassi
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)In Java SE 21, BigDecimal.multiply è un metodo di istanza di java.math.BigDecimal. Per moltiplicare due oggetti BigDecimal, scrivi a.multiply(b), non a * b. Entrambe le versioni del metodo restituiscono il prodotto come BigDecimal. Gli oggetti sono immutabili: nessuno dei due operandi cambia. Conserva quindi il valore restituito se ti serve in seguito.
a.multiply(b) restituisce il prodotto esatto. La scala preferita è la somma di a.scale() e b.scale(). Il risultato usa questa scala se la somma è rappresentabile come int. Se la scala non è negativa, indica il numero di cifre dopo il separatore decimale. Quindi 2.50 per 1.25 dà 3.1250, con scala 4, compreso lo zero finale. Se la somma non rientra nell’intervallo del tipo int, JDK 21 può restituire zero con la scala fissata al limite più vicino dell’intervallo. Ad esempio, se a vale zero con scala Integer.MAX_VALUE e b ha scala 1, a.multiply(b) restituisce zero con scala Integer.MAX_VALUE.
a.multiply(b, mc) usa la precisione e la modalità di arrotondamento del MathContext. Una precisione positiva limita il numero di cifre significative del risultato, non il numero di cifre decimali. La scala del risultato può quindi differire dalla somma delle scale degli operandi. Una precisione pari a 0, come in MathContext.UNLIMITED, richiede un prodotto esatto e ignora la modalità di arrotondamento.
Passare null come argomento provoca una NullPointerException. Se il risultato non può essere esatto alla precisione richiesta, RoundingMode.UNNECESSARY provoca una ArithmeticException. Questa eccezione può verificarsi anche se la scala necessaria per il risultato non rientra nell’intervallo del tipo int.
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("2.50");
BigDecimal b = new BigDecimal("1.25");
BigDecimal exact = a.multiply(b);
BigDecimal rounded = a.multiply(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString() + " (scale=" + exact.scale() + ")");
System.out.println(rounded.toPlainString() + " (scale=" + rounded.scale() + ")");
System.out.println(a.toPlainString());
}
}Risultato
3.1250 (scale=4) 3.13 (scale=2) 2.50
Le stringhe forniscono i valori decimali senza conversioni da `double`. La prima riga mostra il prodotto esatto, la seconda il risultato arrotondato a tre cifre significative con `RoundingMode.HALF_UP` e la terza il valore invariato di `a`.
Lezioni correlate
- Java · Lezione 4 · Base · Versione: 2
- Java · Lezione 69 · Base · Versione: 2