BigInteger.Decrement Operator (BigInteger)


Decrements a BigInteger value by 1.

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

public static BigInteger operator --(
	BigInteger value


Type: System.Numerics.BigInteger

The value to decrement.

Return Value

Type: System.Numerics.BigInteger

The value of the value parameter decremented by 1.

The Decrement method defines the decrement operation for BigInteger values. It enables code such as the following:

BigInteger number = 93843112;
Console.WriteLine(--number);               // Displays 93843111

Languages that do not support custom operators can call the Subtract method instead. For example:

BigInteger number1 = BigInteger.Pow(Int32.MaxValue, 2);
number1 = BigInteger.Subtract(number1, BigInteger.One);

Because BigInteger objects are immutable, the Decrement operator creates a new BigInteger object whose value is one less than the BigInteger object represented by value. This means that repeated calls to Decrement may be expensive.

Universal Windows Platform
Available since 8
.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