The method divide(BigInteger p, BigInteger q, RoundingMode mode) of Guava’s BigIntegerMath class returns the result of dividing p by q, rounding using the specified RoundingMode.
Syntax:
public static BigInteger divide(BigInteger p,
BigInteger q,
RoundingMode mode)
Parameters: This method takes the following parameters:
- p: The BigInteger dividend
- q: The BigInteger divisor
- mode: The rounding mode for calculating the division of p and q.
Return Value: This method returns the result of dividing p by q, rounding using the specified RoundingMode.
Exceptions: The method throws ArithmeticException if q == 0, or if mode == UNNECESSARY and a is not an integer multiple of b.
Enum RoundingMode
| Enum Constant | Description |
|---|---|
| CEILING | Rounding mode to round towards positive infinity. |
| DOWN | Rounding mode to round towards zero. |
| FLOOR | Rounding mode to round towards negative infinity. |
| HALF_DOWN | Rounding mode to round towards “nearest neighbor” unless both neighbors are equidistant, in which case round down. |
| HALF_EVEN | Rounding mode to round towards the “nearest neighbor” unless both neighbors are equidistant, in which case, round towards the even neighbor. |
| HALF_UP | Rounding mode to round towards “nearest neighbor” unless both neighbors are equidistant, in which case round up. |
| UNNECESSARY | Rounding mode to assert that the requested operation has an exact result, hence no rounding is necessary. |
| UP | Rounding mode to round away from zero. |
Below examples illustrates the BigIntegerMath.divide() method:
Example 1:
// Java code to show implementation of// divide(BigInteger p, BigInteger q, RoundingMode mode)// method of Guava's BigIntegerMath class import java.math.*;import com.google.common.math.BigIntegerMath; class GFG { // Driver code public static void main(String args[]) { BigInteger dividend1 = BigInteger.valueOf(55); BigInteger divisor1 = BigInteger.valueOf(10); // Using divide() // method of Guava's BigIntegerMath class BigInteger quotient1 = BigIntegerMath .divide(dividend1, divisor1, RoundingMode.HALF_DOWN); System.out.println(dividend1 + " divided by " + divisor1 + " with HALF_DOWN rounding mode: " + quotient1); BigInteger dividend2 = BigInteger.valueOf(55); BigInteger divisor2 = BigInteger.valueOf(10); // Using divide() // method of Guava's BigIntegerMath class BigInteger quotient2 = BigIntegerMath .divide(dividend2, divisor2, RoundingMode.CEILING); System.out.println(dividend2 + " divided by " + divisor2 + " with CEILING rounding mode: " + quotient2); }} |
Output:
55 divided by 10 with HALF_DOWN rounding mode: 5 55 divided by 10 with CEILING rounding mode: 6
Example 2:
// Java code to show implementation of// divide(BigInteger p, BigInteger q, RoundingMode mode)// method of Guava's BigIntegerMath class import java.math.*;import com.google.common.math.BigIntegerMath; class GFG { // Driver code public static void main(String args[]) { try { BigInteger dividend1 = BigInteger.valueOf(25); BigInteger divisor1 = BigInteger.valueOf(0); // Using divide() // method of Guava's BigIntegerMath class // This should raise "ArithmeticException" // as divisor1 = 0 BigInteger quotient1 = BigIntegerMath .divide(dividend1, divisor1, RoundingMode.HALF_DOWN); } catch (Exception e) { System.out.println("Exception: " + e); } }} |
Output:
Exception: java.lang.ArithmeticException: / by zero
