Complex.Pow Method

Definition

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)

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)
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.

Applies to

Pow(Complex, Complex)

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.

Applies to