Java.math.BigDecimal.divideToIntegralValue() Method

Advertisements


Description

The java.math.BigDecimal.divideToIntegralValue(BigDecimal divisor, MathContext mc) returns a BigDecimal whose value is the integer part of (this / divisor). Since the integer part of the exact quotient does not depend on the rounding mode, the rounding mode does not affect the values returned by this method.

The preferred scale of the result is (this.scale() - divisor.scale()). An ArithmeticException is thrown if the integer part of the exact quotient needs more than mc.precision digits.

Declaration

Following is the declaration for java.math.BigDecimal.divideToIntegralValue() method

public BigDecimal divideToIntegralValue(BigDecimal divisor, MathContext mc)

Parameters

  • divisor - value by which this BigDecimal is to be divided

  • mc - the context to use

Return Value

This method returns the integer part of this / divisor

Exception

  • ArithmeticException - if divisor == 0

  • ArithmeticException - if mc.precision > 0 and the result requires a precision of more than mc.precision digits.

Example

The following example shows the usage of math.BigDecimal.divideToIntegralValue() method

package com.tutorialspoint;

import java.math.*;

public class BigDecimalDemo {

public static void main(String[] args) {

        // create 3 BigDecimal objects
        BigDecimal bg1, bg2,bg3;

        bg1 = new BigDecimal("99.8");
        bg2 = new BigDecimal("3");

	MathContext mc = new MathContext(2);

	// divide bg1 with bg2 using mc
	bg3 = bg1.divideToIntegralValue(bg2, mc);

	String str = "Integer part of division result using mc is " +bg3;

	// print bg3 value
	System.out.println( str );
    }
}

Let us compile and run the above program, this will produce the following result:

Integer part of division result using mc is 33



Advertisements
Advertisements