~~NOTOC~~
<=[[4rpl:start| Index]] \\
<=[[4rpl:start#arithmetic| Arithmetic]]

====== mod2 ======
<-a <-b mod2 ->result

===== Description =====
Perform integer division and returns the value (modulo) of the difference. \\
Works differently with negative numbers than [[mod]], if the result of the modulo operation is negative, the divisor will be added to the result.\\
Performs this calculation: ''result = a % b; if (result < 0) result += b;'' \\

When using a positive number as divisor, mod2 is useful for 'wrapping' a value between 0 and the divisor.\\
For example: -50 mod(360) will normally return -50, but using mod2 it will return 310.

If the divisor is a negative number and the result of the normal modulo operation is too, then the divisor still gets added. \\
This means -50 mod2(-360) will return -410 rather than -50

===== Examples =====
<code 4rpl>
-50 360 mod2 Trace # prints 310
</code>

=== See Also ===
  * [[4rpl:commands:mod]]

<=[[4rpl:start| Index]]