KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

BigDecimal.valueOf — decimale waarden maken

Leer de drie overloads van `BigDecimal.valueOf` in Java 21 kennen en ontdek waarom het omzetten van een `double` een ander resultaat kan geven dan de constructor.

Versie: Java SE 21

Syntax

import java.math.BigDecimal;

// Static overloads declared by java.math.BigDecimal:
public static BigDecimal valueOf(long val)
public static BigDecimal valueOf(long unscaledVal, int scale)
public static BigDecimal valueOf(double val)

BigDecimal.valueOf is een statische fabrieksmethode van de klasse java.math.BigDecimal. Met import java.math.BigDecimal; kun je de methode via de klassenaam aanroepen, zonder new. Java SE 21 biedt drie overloads.

valueOf(long) behoudt de gehele waarde en stelt de schaal in op 0. valueOf(long unscaledVal, int scale) geeft de exacte waarde unscaledVal × 10^(−scale) met de opgegeven schaal. Zo geeft BigDecimal.valueOf(1250L, 2) de waarde 12.50 met schaal 2. De schaal kan negatief zijn: BigDecimal.valueOf(125L, -2) heeft de numerieke waarde 12500 en schaal -2.

Voor een eindige double d geeft valueOf(double) hetzelfde resultaat als new BigDecimal(Double.toString(d)): de methode gebruikt de canonieke decimale tekstweergave van d. Daarentegen geeft new BigDecimal(d) de exacte binaire waarde die in d is opgeslagen weer als decimaal getal. Daarom geeft BigDecimal.valueOf(0.1) precies 0.1, terwijl new BigDecimal(0.1) een iets grotere waarde geeft. Beide vormen gooien een NumberFormatException bij NaN en bij positieve of negatieve oneindigheid.

Omzetten herstelt geen precisie die eerder verloren is gegaan. In BigDecimal.valueOf(0.1 + 0.2) vindt de optelling eerst plaats met double, dus het resultaat is 0.30000000000000004. Heb je de exacte decimale tekst al, gebruik dan new BigDecimal("0.1") in plaats van eerst naar double om te zetten. Er is geen overload BigDecimal.valueOf(String).

Voorbeelden

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        double input = 0.1;
        System.out.println(BigDecimal.valueOf(input).toPlainString());
        System.out.println(new BigDecimal(input).toPlainString());
        System.out.println(BigDecimal.valueOf(125L).toPlainString());
        System.out.println(BigDecimal.valueOf(1250L, 2).toPlainString());
        System.out.println(BigDecimal.valueOf(0.1 + 0.2).toPlainString());
    }
}

Resultaat

0.1
0.1000000000000000055511151231257827021181583404541015625
125
12.50
0.30000000000000004

De eerste twee regels vergelijken de fabrieksmethode en de constructor voor dezelfde `double`. De derde en vierde tonen de overloads met gehele getallen, en de laatste toont het effect van een eerdere optelling met `double`. `toPlainString()` geeft de waarde terug als tekst zonder exponentnotatie, en `println` drukt die tekst af.

Gerelateerde lessen

  • Java · Les 4 · Basis · Versie: 2
  • Java · Les 6 · Basis · Versie: 2

Bronnen