CKTIS / Java
BigDecimal.subtract — odčítání desetinných čísel
Odečti dvě hodnoty `BigDecimal` přesně nebo výsledek zaokrouhli podle nastavení `MathContext`. Ani jeden operand se nezmění.
Verze: Java SE 21
Syntaxe
public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)BigDecimal.subtract je instanční metoda třídy java.math.BigDecimal. Volání a.subtract(b) vypočítá a − b: metoda odečte argument od objektu, na kterém ji voláš. Na pořadí záleží. Operátor - nelze použít na objekty BigDecimal.
subtract(BigDecimal) vrací přesný rozdíl bez zaokrouhlení. Jeho měřítko je Math.max(a.scale(), b.scale()). Nezáporné měřítko udává počet číslic za desetinným oddělovačem včetně koncových nul. Objekty BigDecimal jsou neměnné, takže oba operandy zůstanou beze změny. Pokud budeš rozdíl potřebovat později, ulož návratovou hodnotu.
subtract(BigDecimal, MathContext) v případě potřeby zaokrouhlí přesný rozdíl podle přesnosti a režimu zaokrouhlování kontextu. Přesnost se počítá ve významných číslicích, nikoli v desetinných místech. Přesnost 0, například u MathContext.UNLIMITED, znamená přesný výpočet bez zaokrouhlení. Pokud je nutné zaokrouhlit, ale režim je RoundingMode.UNNECESSARY, metoda vyvolá ArithmeticException. Předání null místo odečítané hodnoty nebo kontextu vyvolá NullPointerException.
Příklady
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());
}
}Výsledek
11.844 3 11.8 12.30 0.456
Konstruktory s textovým argumentem zachovávají přesné desetinné hodnoty bez převodu přes `double`. Program vypíše přesný rozdíl `11.844`, jeho měřítko `3`, výsledek `11.8` zaokrouhlený na tři významné číslice v režimu `HALF_UP` a nakonec nezměněné operandy `12.30` a `0.456`.
Související lekce
- Java · Lekce 69 · Základní · Verze: 2