Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

BigDecimal.add — přesný a zaokrouhlený součet

Sečtěte hodnoty BigDecimal přesně nebo pomocí MathContext nastavte přesnost výsledku a způsob zaokrouhlení.

Verze: 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 je instanční metoda třídy java.math.BigDecimal. Ve volání a.add(b) jsou sčítanci objekt a a argument b. Dva objekty BigDecimal nelze sečíst operátorem +. Tyto objekty jsou neměnné: metoda vrátí výsledek a žádný ze sčítanců nezmění. Návratovou hodnotu uložte nebo použijte; samotné a.add(b); hodnotu a nezmění.

a.add(b) vrátí přesný součet s měřítkem max(a.scale(), b.scale()). Nezáporné měřítko udává počet desetinných míst včetně koncových nul. Měřítko může být i záporné: při měřítku -2 je hodnota rovna uloženému celému číslu vynásobenému 100.

a.add(b, mc) přijímá MathContext z balíčku java.math. Kladná přesnost omezuje počet platných číslic výsledku, nikoli počet desetinných míst. Metoda v případě potřeby zaokrouhlí přesný součet podle nastaveného režimu, takže měřítko výsledku se může změnit. Při kladné přesnosti, pokud je právě jeden sčítanec nulový, má výsledek číselnou hodnotu nenulového sčítance, případně zaokrouhlenou. Měřítko výsledku se může od měřítka nenulového sčítance lišit, i když zaokrouhlení není nutné. Například přičtením 0.00 k 1 při přesnosti 3 vznikne 1.00. Přesnost 0 jako v MathContext.UNLIMITED znamená sčítání bez zaokrouhlení.

Pokud by zaokrouhlení změnilo hodnotu, režim RoundingMode.UNNECESSARY vyvolá výjimku ArithmeticException. Předání null jako b nebo mc vyvolá výjimku 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.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());
    }
}

Výsledek

12.750
12.8
12.40

Sčítanci vzniknou z řetězců, aby se předešlo předchozímu převodu na `double`. Přesný součet `12.750` má měřítko 3; při třech platných číslicích dává `HALF_UP` výsledek `12.8`. Poslední řádek ukazuje, že `a` má stále hodnotu `12.40`.

Související lekce

  • Java · Lekce 4 · Základní · Verze: 2
  • Java · Lekce 69 · Základní · Verze: 2

Zdroje