Complex.Pow Method

Definition

Namespace:

System.Numerics

Assembly:

System.Runtime.Numerics.dll

Returns a specified complex number raised to a specified power.

Overloads

Pow(Complex, Double)	Returns a specified complex number raised to a power specified by a double-precision floating-point number.
Pow(Complex, Complex)	Returns a specified complex number raised to a power specified by a complex number.

Pow(Complex, Double)

Source:

Complex.cs

Returns a specified complex number raised to a power specified by a double-precision floating-point number.

public:
 static System::Numerics::Complex Pow(System::Numerics::Complex value, double power);

public static System.Numerics.Complex Pow (System.Numerics.Complex value, double power);

static member Pow : System.Numerics.Complex * double -> System.Numerics.Complex

Public Shared Function Pow (value As Complex, power As Double) As Complex

Parameters

value

Complex

A complex number to be raised to a power.

power

Double

A double-precision floating-point number that specifies a power.

Returns

Complex

The complex number value raised to the power power.

Examples

The following example illustrates exponentiation using a complex number and an exponent whose value ranges from -1 to 10.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex value = new Complex(12, -6);
      for (int power = -1; power <= 10; power++)
         Console.WriteLine("{0} ^ {1,2} = {2:N2}", value, power,
                           Complex.Pow(value, power));
   }
}
// The example displays the following output:
//    (12, -6) ^ -1 = (0.07, 0.03)
//    (12, -6) ^  0 = (1.00, 0.00)
//    (12, -6) ^  1 = (12.00, -6.00)
//    (12, -6) ^  2 = (108.00, -144.00)
//    (12, -6) ^  3 = (432.00, -2,376.00)
//    (12, -6) ^  4 = (-9,072.00, -31,104.00)
//    (12, -6) ^  5 = (-295,488.00, -318,816.00)
//    (12, -6) ^  6 = (-5,458,752.00, -2,052,864.00)
//    (12, -6) ^  7 = (-77,822,208.00, 8,118,144.00)
//    (12, -6) ^  8 = (-885,157,632.00, 564,350,976.00)
//    (12, -6) ^  9 = (-7,235,785,728.00, 12,083,157,504.00)
//    (12, -6) ^ 10 = (-14,330,483,712.00, 188,412,604,416.00)

open System.Numerics

let value = Complex(12.0, -6.0)

for power in -1. .. 10. do
    printfn $"{value} ^ {power, 2} = {Complex.Pow(value, power):N2}"
// The example displays the following output:
//    (12, -6) ^ -1 = (0.07, 0.03)
//    (12, -6) ^  0 = (1.00, 0.00)
//    (12, -6) ^  1 = (12.00, -6.00)
//    (12, -6) ^  2 = (108.00, -144.00)
//    (12, -6) ^  3 = (432.00, -2,376.00)
//    (12, -6) ^  4 = (-9,072.00, -31,104.00)
//    (12, -6) ^  5 = (-295,488.00, -318,816.00)
//    (12, -6) ^  6 = (-5,458,752.00, -2,052,864.00)
//    (12, -6) ^  7 = (-77,822,208.00, 8,118,144.00)
//    (12, -6) ^  8 = (-885,157,632.00, 564,350,976.00)
//    (12, -6) ^  9 = (-7,235,785,728.00, 12,083,157,504.00)
//    (12, -6) ^ 10 = (-14,330,483,712.00, 188,412,604,416.00)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim value As New Complex(12, -6)
      For power As Integer = -1 To 10
         Console.WriteLine("{0} ^ {1,2} = {2:N2}", value, power, 
                           Complex.Pow(value, power))
      Next
   End Sub
End Module
' The example displays the following output:
'    (12, -6) ^ -1 = (0.07, 0.03)
'    (12, -6) ^  0 = (1.00, 0.00)
'    (12, -6) ^  1 = (12.00, -6.00)
'    (12, -6) ^  2 = (108.00, -144.00)
'    (12, -6) ^  3 = (432.00, -2,376.00)
'    (12, -6) ^  4 = (-9,072.00, -31,104.00)
'    (12, -6) ^  5 = (-295,488.00, -318,816.00)
'    (12, -6) ^  6 = (-5,458,752.00, -2,052,864.00)
'    (12, -6) ^  7 = (-77,822,208.00, 8,118,144.00)
'    (12, -6) ^  8 = (-885,157,632.00, 564,350,976.00)
'    (12, -6) ^  9 = (-7,235,785,728.00, 12,083,157,504.00)
'    (12, -6) ^ 10 = (-14,330,483,712.00, 188,412,604,416.00)

Remarks

If value is Complex.Zero, the method returns Complex.Zero. For other values, if power is 0, the method returns Complex.One, and if power is 1, it returns value.

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

Pow(Complex, Complex)

Source:

Complex.cs

Returns a specified complex number raised to a power specified by a complex number.

public:
 static System::Numerics::Complex Pow(System::Numerics::Complex value, System::Numerics::Complex power);

public static System.Numerics.Complex Pow (System.Numerics.Complex value, System.Numerics.Complex power);

static member Pow : System.Numerics.Complex * System.Numerics.Complex -> System.Numerics.Complex

Public Shared Function Pow (value As Complex, power As Complex) As Complex

Parameters

value

Complex

A complex number to be raised to a power.

power

Complex

A complex number that specifies a power.

Returns

Complex

The complex number value raised to the power power.