CKTIS / Java
BigDecimal.add — addition exacte ou avec arrondi
Additionnez des valeurs BigDecimal sans arrondi ou utilisez MathContext pour fixer la précision et le mode d’arrondi du résultat.
Version : Java SE 21
Syntaxe
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 est une méthode d’instance de java.math.BigDecimal. Dans a.add(b), l’objet a et l’argument b sont les deux termes de la somme. On ne peut pas additionner deux objets BigDecimal avec +. Ces objets sont immuables : la méthode renvoie le résultat sans modifier les termes. Conservez ou utilisez la valeur renvoyée ; a.add(b); seul ne met pas a à jour.
a.add(b) renvoie la somme exacte avec l’échelle max(a.scale(), b.scale()). Une échelle positive ou nulle indique le nombre de chiffres après le séparateur décimal, y compris les zéros finaux. L’échelle peut être négative : avec -2, la valeur est l’entier stocké multiplié par 100.
a.add(b, mc) prend un MathContext de java.math. Une précision positive limite le nombre de chiffres significatifs du résultat, pas le nombre de décimales. La méthode arrondit la somme exacte si nécessaire selon le mode indiqué ; l’échelle du résultat peut donc changer. Avec une précision positive, si un seul des deux termes vaut zéro, le résultat prend la valeur numérique du terme non nul, arrondie si nécessaire. L’échelle du résultat peut différer de celle du terme non nul, même si aucun arrondi n’est nécessaire. Par exemple, ajouter 0.00 à 1 avec une précision de 3 donne 1.00. Une précision de 0, comme dans MathContext.UNLIMITED, signifie que l’addition se fait sans arrondi.
Si l’arrondi devait modifier la valeur, RoundingMode.UNNECESSARY provoque une ArithmeticException. Passer null comme b ou mc provoque une NullPointerException.
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("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());
}
}Résultat
12.750 12.8 12.40
Les termes sont construits à partir de chaînes pour éviter une conversion préalable en `double`. La somme exacte `12.750` a une échelle de 3 ; avec trois chiffres significatifs, `HALF_UP` donne `12.8`. La dernière ligne montre que `a` vaut toujours `12.40`.
Leçons associées
- Java · Leçon 4 · Débutant · Version : 2
- Java · Leçon 69 · Débutant · Version : 2