Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

BigDecimal.add — presný a zaokrúhlený súčet

Sčítajte hodnoty BigDecimal presne alebo pomocou MathContext nastavte presnosť výsledku a režim zaokrúhľovania.

Verzia: Java SE 21

Syntax

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 inštančná metóda triedy java.math.BigDecimal. Pri volaní a.add(b) sú sčítancami objekt a a argument b. Dva objekty BigDecimal nemožno sčítať operátorom +. Tieto objekty sú nemenné: metóda vráti výsledok a nezmení ani jeden sčítanec. Návratovú hodnotu uložte alebo použite; samotné a.add(b); hodnotu a nezmení.

a.add(b) vráti presný súčet s mierkou max(a.scale(), b.scale()). Nezáporná mierka udáva počet desatinných miest vrátane koncových núl. Mierka môže byť aj záporná: pri mierke -2 je hodnotou uložené celé číslo vynásobené 100.

a.add(b, mc) prijíma MathContext z balíka java.math. Kladná presnosť obmedzuje počet platných číslic výsledku, nie počet desatinných miest. Metóda podľa potreby zaokrúhli presný súčet podľa režimu v kontexte, takže mierka výsledku sa môže zmeniť. Pri kladnej presnosti, ak je práve jeden sčítanec nulový, má výsledok číselnú hodnotu nenulového sčítanca, podľa potreby zaokrúhlenú. Mierka výsledku sa môže líšiť od mierky nenulového sčítanca aj vtedy, keď zaokrúhľovanie nie je potrebné. Napríklad pripočítaním 0.00 k 1 pri presnosti 3 dostaneme 1.00. Presnosť 0 ako v MathContext.UNLIMITED znamená sčítanie bez zaokrúhľovania.

Ak by zaokrúhlenie zmenilo hodnotu, režim RoundingMode.UNNECESSARY vyvolá výnimku ArithmeticException. Odovzdanie null ako b alebo mc vyvolá výnimku NullPointerException.

Prí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ýsledok

12.750
12.8
12.40

Sčítance vzniknú z reťazcov, aby sa predišlo predchádzajúcej konverzii na `double`. Presný súčet `12.750` má mierku 3; pri troch platných čísliciach dáva `HALF_UP` výsledok `12.8`. Posledný riadok ukazuje, že `a` má stále hodnotu `12.40`.

Súvisiace lekcie

  • Java · Lekcia 4 · Základná · Verzia: 2
  • Java · Lekcia 69 · Základná · Verzia: 2

Zdroje