# Java.math.BigDecimal.divide() Method

## Description

The java.math.BigDecimal.divide(BigDecimal divisor, int scale, RoundingMode roundingMode) returns a BigDecimal whose value is (this / divisor), and whose scale is as specified. If rounding must be performed to generate a result with the specified scale, the specified rounding mode is applied.

## Declaration

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

```public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)
```

## Parameters

• divisor − Value by which this BigDecimal is to be divided.

• scale − Scale of the BigDecimal quotient to be returned.

• roundingMode − Rounding mode to apply.

## Return Value

This method returns a BigDecimal object whose value is this / divisor rounded as specified to given scale

## Exception

ArithmeticException − If divisor is zero, roundingMode == RoundingMode.UNNECESSARY and the specified scale is insufficient to represent the result of the division exactly

## Example

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

```package com.tutorialspoint;

import java.math.*;
import java.lang.*;

public class BigDecimalDemo {

public static void main(String[] args) {

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

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

// divide bg1 with bg2 with 3 scale
bg3 = bg1.divide(bg2, 3, RoundingMode.CEILING);

String str = "Division result is " +bg3;

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

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

```Division result is 5.334
```
java_math_bigdecimal.htm