BigInteger.Pow Method (BigInteger, Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Raises a BigInteger value to the power of a specified value.

Namespace:   System.Numerics
Assembly:  System.Numerics (in System.Numerics.dll)

Public Shared Function Pow (
	value As BigInteger,
	exponent As Integer
) As BigInteger


Type: System.Numerics.BigInteger

The number to raise to the exponent power.

Type: System.Int32

The exponent to raise value by.

Return Value

Type: System.Numerics.BigInteger

The result of raising value to the exponent power.

Exception Condition

The value of the exponent parameter is negative.

The Pow method returns 1 if the value of the exponent parameter is 0, or if the values of both the value and exponent parameters are 0. If exponent is 1, the Pow method returns value. If value is negative, the method returns a negative result.

This method corresponds to the Math.Pow method for primitive numeric types.

The following example illustrates exponentiation using a BigInteger value and an exponent whose value ranges from 0 to 10.

Dim base As BigInteger = 3040506
For ctr As Integer = 0 To 10
   Console.WriteLine(BigInteger.Pow(base, ctr))
' The example produces the following output to the console:
' 1
' 3040506
' 9244676736036
' 28108495083977874216
' 85464047953805230420993296
' 259853950587832525926412642447776
' 790087495886008322074413197838317614656
' 2402265771766383619317185774506591737267255936
' 7304103492650319992835619250501939216711515276943616
' 22208170494024253840136657344866649200046662468638726109696
' 67524075636103707946458547477011116092637077515870858568887346176     '

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Available since 4.0
Windows Phone
Available since 8.1
Return to top