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