Divides two values and pushes the remainder onto the evaluation stack.
Assembly: mscorlib (in mscorlib.dll)
The following table lists the instruction's hexadecimal and Microsoft Intermediate Language (MSIL) assembly format, along with a brief reference summary:
Pushes the remainder of dividing value1 by value2 onto the stack.
The stack transitional behavior, in sequential order, is:
A value1 is pushed onto the stack.
value2 is pushed onto the stack.
value2 and value1 are popped from the stack and the remainder of value1 div value2 computed.
The result is pushed onto the stack.
result = value1 rem value2 satisfies the following conditions:
result = value1 - value2 × (value1 div value2), and:
0 = | result | < | value2 |, sign(result) = sign(value1), where div is the division instruction that truncates towards zero.
If value2 is zero or value1 is infinity the result is NaN. If value2 is infinity, the result is value1 (negated for -infinity).
Integral operations throw DivideByZeroException if value2 is zero.
Note that on the Intel-based platforms an OverflowException is thrown when computing (minint rem -1).
The following Emit method overload can use the rem opcode:
Available since 4.5
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.1
Available since 8.1