Java.math.BigDecimal.pow() Method

Description

The java.math.BigDecimal.pow(int n) returns a BigDecimal whose value is (thisⁿ), The power is computed exactly, to unlimited precision.

The parameter n must be in the range 0 through 999999999, inclusive. ZERO.pow(0) returns ONE.

Declaration

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

public BigDecimal pow(int n)

Parameters

n − Power to raise this BigDecimal to.

Return Value

This method returns the value of BigDecimal Object raised to the power of n i.e thisⁿ.

Exception

ArithmeticException − If n is out of range.

Example

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

package com.tutorialspoint;

import java.math.*;

public class BigDecimalDemo {

   public static void main(String[] args) {

      // create 2 BigDecimal Objects
      BigDecimal bg1, bg2;

      bg1 = new BigDecimal("2.17");

      // apply pow method on bg1 
      bg2 = bg1.pow(3);

      String str = "The value of " + bg1 + " to the power of 3 is " + bg2;

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

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

The value of 2.17 to the power of 3 is 10.218313