Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

BigDecimal.add — natančno in zaokroženo seštevanje

Seštejte vrednosti BigDecimal brez zaokroževanja ali z MathContext določite natančnost rezultata in način zaokroževanja.

Različica: Java SE 21

Sintaksa

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 metoda primerka razreda java.math.BigDecimal. Pri klicu a.add(b) sta seštevanca objekt a in argument b. Dveh objektov BigDecimal ni mogoče sešteti z operatorjem +. Objekti so nespremenljivi: metoda vrne rezultat in ne spremeni nobenega seštevanca. Vrnjeno vrednost shranite ali uporabite; sam klic a.add(b); ne spremeni a.

a.add(b) vrne natančno vsoto z merilom max(a.scale(), b.scale()). Nenegativno merilo določa število decimalnih mest, vključno s končnimi ničlami. Merilo je lahko tudi negativno: pri merilu -2 je vrednost shranjeno celo število, pomnoženo s 100.

a.add(b, mc) sprejme MathContext iz paketa java.math. Pozitivna natančnost omeji število značilnih števk rezultata, ne števila decimalnih mest. Metoda po potrebi zaokroži natančno vsoto po načinu iz konteksta, zato se merilo rezultata lahko spremeni. Če je pri pozitivni natančnosti natanko en seštevanec nič, ima rezultat številsko vrednost neničelnega seštevanca, po potrebi zaokroženo. Merilo rezultata se lahko razlikuje od merila neničelnega seštevanca, tudi če zaokroževanje ni potrebno. Če na primer pri natančnosti 3 prištejemo 0.00 k 1, dobimo 1.00. Natančnost 0, kot pri MathContext.UNLIMITED, pomeni seštevanje brez zaokroževanja.

Če bi zaokroževanje spremenilo vrednost, način RoundingMode.UNNECESSARY sproži izjemo ArithmeticException. Če kot b ali mc podate null, se sproži izjema NullPointerException.

Primeri

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());
    }
}

Rezultat

12.750
12.8
12.40

Seštevanca ustvarimo iz nizov, da se izognemo predhodni pretvorbi v `double`. Natančna vsota `12.750` ima merilo 3; pri treh značilnih števkah način `HALF_UP` da `12.8`. Zadnja vrstica pokaže, da je vrednost `a` še vedno `12.40`.

Povezane lekcije

  • Java · Lekcija 4 · Osnovna · Različica: 2
  • Java · Lekcija 69 · Osnovna · Različica: 2

Viri