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

CKTIS / Java

BigDecimal.setScale — spreminjanje merila in zaokroževanje

Nastavite merilo števila `BigDecimal`, ne da bi spremenili njegovo vrednost, ali izrecno izberite način zaokroževanja. Prvotni objekt ostane nespremenjen.

Različica: Java SE 21

Sintaksa

public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)

BigDecimal.setScale je metoda primerka razreda java.math.BigDecimal. Nenegativno merilo pove, koliko je decimalnih mest; merilo -1 pomeni večkratnike števila deset. Merilo ni isto kot natančnost (število števk v vrednosti brez merila). Metoda vrne BigDecimal, ne oblikovanega besedila. Prvotni objekt je nespremenljiv, zato uporabite vrnjeno vrednost; zanjo ni nujno ustvarjen nov objekt.

setScale(int) ohrani številsko vrednost. V decimalnem zapisu lahko povečanje merila doda končne ničle, pri zmanjšanju brez spremembe vrednosti pa se lahko odstranijo samo ničle. Če bi bilo potrebno zaokroževanje, metoda sproži izjemo ArithmeticException.

setScale(int, RoundingMode) uporabi izbrani način iz java.math.RoundingMode, kadar zmanjšanje merila zahteva zaokroževanje. HALF_UP izbere najbližjo vrednost pri ciljnem merilu, pri enaki oddaljenosti pa zaokroži stran od nič: 2.675 pri merilu 2 postane 2.68. UNNECESSARY zahteva točen rezultat in povzroči izjemo ArithmeticException, če je potrebno zaokroževanje.

Preobremenjena različica setScale(int, int) je zastarela od Jave 9 in sproži izjemo IllegalArgumentException, če drugi argument ne predstavlja veljavnega načina zaokroževanja. V novi kodi uporabljajte različico z RoundingMode. Za točen decimalni vnos uporabite new BigDecimal("2.675") namesto new BigDecimal(2.675), ki prevzame dvojiški približek tipa double.

Primeri

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("2.675");
        BigDecimal padded = original.setScale(4);
        System.out.println(padded.toPlainString());
        System.out.println(padded.setScale(3).toPlainString());
        System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());

        try {
            original.setScale(2);
        } catch (ArithmeticException e) {
            System.out.println("ArithmeticException");
        }

        System.out.println(original.toPlainString());
    }
}

Rezultat

2.6750
2.675
2.68
ArithmeticException
2.675

Prvi dve vrstici prikazujeta dodajanje in odstranjevanje končne ničle brez spremembe vrednosti. Tretja prikazuje zaokrožitev, četrta sporoči, da je bila izjema prestrežena, zadnja pa izpiše nespremenjeno prvotno vrednost.

Povezane lekcije

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

Viri