• Article

Complex.Subtract Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Subtracts one complex number from another and returns the result.

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

Syntax

'Declaration
Public Shared Function Subtract ( _
    left As Complex, _
    right As Complex _
) As Complex

public static Complex Subtract(
    Complex left,
    Complex right
)

Parameters

Return Value

Type: System.Numerics.Complex
The result of subtracting right from left.

Remarks

The subtraction of a complex number, c + di, from another complex number, a + bi, takes the following form:

(a - c) + (b - d)i

If the method call results in an overflow in either the real or imaginary component, the value of that component is either Double.PositiveInfinity or Double.NegativeInfinity.

Languages that do not support custom operators can use the Subtract method to perform subtraction using complex numbers.

Examples

The following example subtracts each complex number in an array from a complex number.

Imports System.Numerics

Module Example
   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      Dim c1 As New Complex(4.93, 6.87)
      Dim values() As Complex = { New Complex(12.5, 9.6), 
                                  New Complex(4.3, -8.1), 
                                  New Complex(-1.9, 7.4), 
                                  New Complex(-5.3, -6.6) }

      For Each c2 In values
         outputBlock.Text += String.Format("{0} - {1} = {2}", c1, c2,  
                           Complex.Subtract(c1, c2)) + vbCrLf
      Next
   End Sub
End Module
' The example displays the following output:
'       (4.93, 6.87) - (12.5, 9.6) = (-7.57, -2.73)
'       (4.93, 6.87) - (4.3, -8.1) = (0.63, 14.97)
'       (4.93, 6.87) - (-1.9, 7.4) = (6.83, -0.53)
'       (4.93, 6.87) - (-5.3, -6.6) = (10.23, 13.47)

using System;
using System.Numerics;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      Complex c1 = new Complex(4.93, 6.87);
      Complex[] values = { new Complex(12.5, 9.6), 
                           new Complex(4.3, -8.1), 
                           new Complex(-1.9, 7.4), 
                           new Complex(-5.3, -6.6) };

      foreach (var c2 in values)
         outputBlock.Text += String.Format("{0} - {1} = {2}", c1, c2,
                           Complex.Subtract(c1, c2)) + "\n";
   }
}
// The example displays the following output:
//       (4.93, 6.87) - (12.5, 9.6) = (-7.57, -2.73)
//       (4.93, 6.87) - (4.3, -8.1) = (0.63, 14.97)
//       (4.93, 6.87) - (-1.9, 7.4) = (6.83, -0.53)
//       (4.93, 6.87) - (-5.3, -6.6) = (10.23, 13.47)

Version Information

Silverlight

Supported in: 5, 4

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.