Differences

This shows you the differences between two versions of the page.

--- 4rpl:commands:mod2 [2021/01/20 15:40] – crosslinked mod and mod2 Karsten75
+++ 4rpl:commands:mod2 [2025/02/14 14:57] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ~~NOTOC~~
-<=[[4rpl:start| Index]]
+<=[[4rpl:start| Index]] \\
+<=[[4rpl:start#arithmetic| Arithmetic]]
 ====== mod2 ======
@@ Line 6: / Line 7: @@
 ===== Description =====
-Perform integer division and returns the value (modulo) of the difference.
+Perform integer division and returns the value (modulo) of the difference. \\
-Works differently with negative numbers than [[mod]].
+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
+Performs this calculation: ''result = a % b; if (result < 0) result += b;'' \\
-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>
-trace(5 3 mod2) #prints '2'
+-50 360 mod2 Trace # prints 310
 </code>
+=== See Also ===
+  * [[4rpl:commands:mod]]
 <=[[4rpl:start| Index]]

Knuckle Cracker Wiki