Added a randi() function to generate random integers

doc/functions.md

@@ -261,6 +261,14 @@ Works without any arguments.
 x = rand() // any number between 0 and 1
 ```
 
+### Generate Single Random Integer
+
+Works with one argument.
+
+```
+x = randi(5) // any integer between 0 and 5
+```
+
 ### Generate Random Vector
 
 Works with one argument.

src/Mages.Core/Runtime/Functions/SimpleRandom.cs

@@ -27,6 +27,12 @@ public static Double GetNumber()
         return _random.NextDouble();
     }
 
+    public static Int32 GetInteger(Int32 maximum)
+    {
+        EnsureRandom();
+        return (Int32)Math.Round(_random.NextDouble() * maximum);
+    }
+
     private static Double[,] CreateMatrix(Int32 rows, Int32 cols)
     {
         var matrix = new Double[rows, cols];

src/Mages.Core/Runtime/Functions/StandardFunctions.cs

@@ -686,6 +686,11 @@ public static class StandardFunctions
         (args.Length > 0 ? If.Is<Double>(args, SimpleRandom.CreateVector) : null) ??
         SimpleRandom.GetNumber());
 
+    /// <summary>
+    /// Contains the random integer function.
+    /// </summary>
+    public static readonly Function Randi = new(args => SimpleRandom.GetInteger((int)args[0]));
+
     /// <summary>
     /// Contains the throw function.
     /// </summary>

src/Mages.Core/Runtime/Global.cs

@@ -41,6 +41,7 @@ static class Global
         { "gamma", StandardFunctions.Gamma },
         { "sqrt", StandardFunctions.Sqrt },
         { "rand", StandardFunctions.Rand },
+        { "randi", StandardFunctions.Randi },
         { "sin", StandardFunctions.Sin },
         { "cos", StandardFunctions.Cos },
         { "tan", StandardFunctions.Tan },