BigInteger.Increment(BigInteger) Operator

Definition

Increments a BigInteger value by 1.

public static System.Numerics.BigInteger operator ++ (System.Numerics.BigInteger value);

Parameters

value
BigInteger

The value to increment.

Returns

The value of the value parameter incremented by 1.

Implements

Remarks

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

BigInteger number = 93843112;
Console.WriteLine(++number);               // Displays 93843113

Some languages (such as Visual Basic) that lack an increment operator or do not support operator overloading can call the Increment method directly, as the following example shows.

Dim number As BigInteger = 93843112
Console.WriteLine(BigInteger.op_Increment(number))    ' Displays 93843113

Because BigInteger objects are immutable, the Increment operator creates a new BigInteger object whose value is one more than the BigInteger object represented by value. Therefore, repeated calls to Increment may be expensive.

The equivalent method for this operator is BigInteger.Add(BigInteger, BigInteger).

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

See also