Subtract Method

BigInteger.Subtract Method (BigInteger, BigInteger)


Subtracts one BigInteger value from another and returns the result.

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

public static BigInteger Subtract(
	BigInteger left,
	BigInteger right


Type: System.Numerics.BigInteger

The value to subtract from (the minuend).

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

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Available since 4.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft