Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

BigDecimal.subtract — soustraire des nombres décimaux

Soustrayez deux valeurs `BigDecimal` exactement ou arrondissez leur différence selon un `MathContext`. Aucun des deux opérandes n’est modifié.

Version : Java SE 21

Syntaxe

public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)

BigDecimal.subtract est une méthode d’instance de java.math.BigDecimal. L’appel a.subtract(b) calcule a − b : il soustrait l’argument de l’objet sur lequel la méthode est appelée. L’ordre compte. L’opérateur - ne s’applique pas aux objets BigDecimal.

subtract(BigDecimal) renvoie la différence exacte, sans arrondi, avec une échelle égale à Math.max(a.scale(), b.scale()). Une échelle positive ou nulle indique le nombre de chiffres après le séparateur décimal, zéros finaux compris. BigDecimal est immuable : les deux opérandes restent inchangés. Enregistrez la valeur renvoyée si vous avez besoin de la différence plus tard.

subtract(BigDecimal, MathContext) arrondit la différence exacte si nécessaire, selon la précision et le mode d’arrondi du contexte. La précision compte les chiffres significatifs, pas les décimales. Une précision de 0, comme dans MathContext.UNLIMITED, signifie que le calcul est exact, sans arrondi. Si un arrondi est nécessaire alors que le mode est RoundingMode.UNNECESSARY, la méthode lève une ArithmeticException. Passer null comme valeur à soustraire ou comme contexte 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.30");
        BigDecimal b = new BigDecimal("0.456");

        BigDecimal exact = a.subtract(b);
        BigDecimal rounded = a.subtract(b, new MathContext(3, RoundingMode.HALF_UP));

        System.out.println(exact.toPlainString());
        System.out.println(exact.scale());
        System.out.println(rounded.toPlainString());
        System.out.println(a.toPlainString());
        System.out.println(b.toPlainString());
    }
}

Résultat

11.844
3
11.8
12.30
0.456

Les constructeurs qui prennent des chaînes conservent les valeurs décimales exactes sans passer par `double`. Le programme affiche la différence exacte `11.844`, son échelle `3`, le résultat `11.8` arrondi à trois chiffres significatifs avec `HALF_UP`, puis les opérandes inchangés `12.30` et `0.456`.

Leçons associées

  • Java · Leçon 69 · Débutant · Version : 2

Sources