BigInteger.Subtract Method

Subtracts one BigInteger value from another and returns the result.

Namespace:  System.Numerics
Assemblies:   System.Runtime.Numerics (in System.Runtime.Numerics.dll)
  System.Numerics (in System.Numerics.dll)

public static BigInteger Subtract(
	BigInteger left,
	BigInteger right
)

Parameters

left
Type: System.Numerics.BigInteger

The value to subtract from (the minuend).

right
Type: System.Numerics.BigInteger

The value to subtract (the subtrahend).

Return Value

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

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

The Subtract method is a useful substitute for the subtraction operator when instantiating a BigInteger variable by assigning it the difference that results from subtraction, as shown in the following example.

// The statement 
//    BigInteger number = Int64.MinValue - Int64.MaxValue; 
// produces compiler error CS0220: The operation overflows at compile time in checked mode. 
// The alternative:
BigInteger number = BigInteger.Subtract(Int64.MinValue, Int64.MaxValue);     

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

.NET for Windows Phone apps

Supported in: Windows Phone 8.1

Portable Class Library

Supported in: Portable Class Library
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft