BigInteger.Pow(BigInteger, Int32) Método

Referência

Definição

Namespace:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Gera um valor BigInteger à potência de um valor especificado.

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

Parâmetros

value: BigInteger

O número a ser elevado à potência exponent.

exponent: Int32

O expoente pelo qual value será elevado.

Retornos

BigInteger

O resultado da elevação value para a potência exponent.

Exceções

ArgumentOutOfRangeException

exponent é negativo.

Exemplos

O exemplo a seguir ilustra a exponencialidade usando um BigInteger valor e um expoente cujo valor varia de 0 a 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     //

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     '

Comentários

O Pow método retornará 1 se o valor do parâmetro expoente for 0 ou se os valores de ambos value e exponent parâmetros forem 0. Se exponent for 1, o Pow método retornará value. Se value for negativo, o método retornará um resultado negativo.

Esse método corresponde ao Math.Pow método para tipos numéricos primitivos.

Aplica-se a