This documentation is archived and is not being maintained.

Complex.Subtract Method

Visual Studio 2010

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
```

Parameters

left
Type: System.Numerics.Complex
The value to subtract from (the minuend).
right
Type: System.Numerics.Complex
The value to subtract (the subtrahend).

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 Main()
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
Console.WriteLine("{0} - {1} = {2}", c1, c2,
Complex.Subtract(c1, c2))
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)

```

Supported in: 4

Supported in: 4

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.