Differences

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

--- crpl:docs:randint [2013/01/14 14:06] – created chani
+++ crpl:docs:randint [2020/05/26 18:23] – Added a Note and example for special cases Sanian
@@ Line 1: / Line 1: @@
-TODO
+<- [[crpl:crplreference|CRPL reference]] <- [[crpl:crplreference#utility_commands|Utility Commands]]
+=====  RandInt  =====
+^Arguments^Result^Notation^
+|Min, Max|Random Integer |''n1 n2 -- n2 ''|
+=== Description ===
+Pops Min and Max from the stack and pushes a random integer to stack where ''min <= RandInt < max''.
+**Note:** Min may be higher than Max, however the resulting value will follow a different rule where ''min >= RandInt > max''
+=== Examples ===
+<code>
+#Creates a dancing number readout. Very high tech hackery.
+10 RandInt
+10 RandInt concat
+10 RandInt concat
+10 RandInt concat
+SetPopupText
+:awake
+  TRUE OperateWhilePaused
+</code>
+<code>
+# Showcases the difference between passing (Low, High) or (High, Low) into the function.
+once
+    ClearTraceLog
+    ShowTraceLog
+0 do
+        #       min  max                     results         logic
+        "lohi " -2    2   RandInt " "     #  -2 -1 0 1       min <= RandInt < max
+        "hilo "  2   -2   RandInt Trace5  #     -1 0 1 2     min >= RandInt > max
+    loop
+endonce
+</code>

Knuckle Cracker Wiki