BigInteger.Pow(BigInteger, Int32) Method

Definition

Namespace:

System.Numerics

Assembly:

System.Runtime.Numerics.dll

Source:

BigInteger.cs

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

public:
 static System::Numerics::BigInteger Pow(System::Numerics::BigInteger value, int exponent);

public static System.Numerics.BigInteger Pow (System.Numerics.BigInteger value, int exponent);

static member Pow : System.Numerics.BigInteger * int -> System.Numerics.BigInteger

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

Parameters

value

BigInteger

The number to raise to the exponent power.

exponent

Int32

The exponent to raise value by.

Returns

BigInteger

The result of raising value to the exponent power.

Exceptions

ArgumentOutOfRangeException

exponent is negative.

Examples

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

BigInteger numericBase = 3040506;
for (int ctr = 0; ctr <= 10; ctr++)
{
   Console.WriteLine(BigInteger.Pow(numericBase, ctr));
}
//
// The example produces the following output to the console:
//
// 1
// 3040506
// 9244676736036
// 28108495083977874216
// 85464047953805230420993296
// 259853950587832525926412642447776
// 790087495886008322074413197838317614656
// 2402265771766383619317185774506591737267255936
// 7304103492650319992835619250501939216711515276943616
// 22208170494024253840136657344866649200046662468638726109696
// 67524075636103707946458547477011116092637077515870858568887346176     //

let numericBase = 3040506I

for ctr in 0..10 do
    printfn $"{BigInteger.Pow(numericBase, ctr)}"
//
// The example produces the following output to the console:
//
// 1
// 3040506
// 9244676736036
// 28108495083977874216
// 85464047953805230420993296
// 259853950587832525926412642447776
// 790087495886008322074413197838317614656
// 2402265771766383619317185774506591737267255936
// 7304103492650319992835619250501939216711515276943616
// 22208170494024253840136657344866649200046662468638726109696
// 67524075636103707946458547477011116092637077515870858568887346176

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

Remarks

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.