CKTIS / Java
Multiplier des nombres décimaux avec BigDecimal.multiply
Multipliez deux valeurs `BigDecimal` exactement, ou arrondissez leur produit selon la précision et le mode d’arrondi définis dans un `MathContext`.
Version : Java SE 21
Syntaxe
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)Dans Java SE 21, BigDecimal.multiply est une méthode d’instance de java.math.BigDecimal. Pour multiplier deux objets BigDecimal, écrivez a.multiply(b) et non a * b. Les deux surcharges renvoient le produit sous forme de BigDecimal. Les objets sont immuables : aucun des opérandes ne change. Conservez donc la valeur renvoyée si vous en avez besoin par la suite.
a.multiply(b) renvoie le produit exact. L’échelle privilégiée est la somme de a.scale() et de b.scale(). Le résultat utilise cette échelle lorsque la somme est représentable par un int. Quand l’échelle est positive ou nulle, elle indique le nombre de chiffres après le séparateur décimal. Ainsi, 2.50 multiplié par 1.25 donne 3.1250, d’échelle 4, zéro final compris. Si la somme est hors de la plage du type int, le JDK 21 peut renvoyer zéro avec une échelle fixée à la borne la plus proche de cette plage. Par exemple, si a vaut zéro avec une échelle de Integer.MAX_VALUE et que b a une échelle de 1, a.multiply(b) renvoie zéro avec une échelle de Integer.MAX_VALUE.
a.multiply(b, mc) utilise la précision et le mode d’arrondi du MathContext. Une précision positive limite le nombre de chiffres significatifs du résultat, et non le nombre de décimales. L’échelle du résultat peut donc différer de la somme des échelles des opérandes. Une précision de 0, comme dans MathContext.UNLIMITED, demande un produit exact sans appliquer le mode d’arrondi.
Passer null en argument déclenche une NullPointerException. Si le résultat ne peut pas être exact à la précision demandée, RoundingMode.UNNECESSARY déclenche une ArithmeticException. Cette exception peut aussi se produire si l’échelle nécessaire au résultat est hors de la plage du type int.
Exemples
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());
}
}Résultat
3.1250 (scale=4) 3.13 (scale=2) 2.50
Les chaînes fournissent les valeurs décimales sans conversion depuis `double`. La première ligne affiche le produit exact, la deuxième le résultat arrondi à trois chiffres significatifs avec `RoundingMode.HALF_UP`, et la troisième la valeur inchangée de `a`.
Leçons associées
- Java · Leçon 4 · Débutant · Version : 2
- Java · Leçon 69 · Débutant · Version : 2