BigInteger.Modulus Operator (BigInteger, BigInteger)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.


Returns the remainder that results from division with two specified BigInteger values.

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

public static BigInteger operator %(
	BigInteger dividend,
	BigInteger divisor


Type: System.Numerics.BigInteger

The value to be divided.

Type: System.Numerics.BigInteger

The value to divide by.

Return Value

Type: System.Numerics.BigInteger

The remainder that results from the division.

Exception Condition

divisor is 0 (zero).

The Modulus method defines the operation of the modulus operator for BigInteger values. It enables code such as the following:

BigInteger num1 = 100045632194;
BigInteger num2 = 90329434;
BigInteger remainder = num1 % num2;
Console.WriteLine(remainder);           // Displays 50948756

Languages that do not support custom operators can call the BigInteger.Remainder method instead.

The sign of the value returned by the modulus operation depends on the sign of dividend: If dividend is positive, the modulus operation returns a positive result; if it is negative, the modulus operation returns a negative result. The behavior of the modulus operation with BigInteger values is identical to the modulus operation with other integral types.

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