added math function 'rand-bigint'

ChangeLog.md

@@ -14,6 +14,7 @@ All notable changes to this project will be documented in this file.
 - thread type support to the function `thread` to allow spawning daemon or user 
   threads
 - support for tracing exceptions in `trace/trace-var`
+- math function `rand-bigint`
 
 
 

src/main/java/com/github/jlangch/venice/impl/docgen/cheatsheet/section/MathSection.java

@@ -74,6 +74,7 @@ public DocSection section() {
         all.addSection(random);
         random.addItem(diBuilder.getDocItem("rand-long"));
         random.addItem(diBuilder.getDocItem("rand-double"));
+        random.addItem(diBuilder.getDocItem("rand-bigint"));
         random.addItem(diBuilder.getDocItem("rand-gaussian"));
 
         final DocSection trigonometry = new DocSection("Trigonometry", "math.trigonometry");

src/main/java/com/github/jlangch/venice/impl/functions/MathFunctions.java

@@ -1539,6 +1539,7 @@ else if (q == 1.0D) {
                         "(rand-long 100)")
                     .seeAlso(
                     	"rand-double",
+                    	"rand-bigint",
                     	"rand-gaussian",
                     	"bytebuf-allocate-random")
                     .build()
@@ -1581,8 +1582,9 @@ public VncVal apply(final VncList args) {
                         "(rand-double 100.0)")
                     .seeAlso(
                     	"rand-long",
+                       	"rand-bigint",
                     	"rand-gaussian",
-                    	"bytebuf-allocate-random")
+                     	"bytebuf-allocate-random")
                     .build()
         ) {
             @Override
@@ -1627,6 +1629,7 @@ public VncVal apply(final VncList args) {
                     .seeAlso(
                     	"rand-long",
                     	"rand-double",
+                    	"rand-bigint",
                     	"bytebuf-allocate-random")
                     .build()
         ) {
@@ -1647,6 +1650,42 @@ public VncVal apply(final VncList args) {
             private static final long serialVersionUID = -1848883965231344442L;
         };
 
+    public static VncFunction rand_bigint =
+        new VncFunction(
+                "rand-bigint",
+                VncFunction
+                    .meta()
+                    .arglists(
+                        "(rand-bigint bits)")
+                    .doc(
+                        "Constructs a randomly generated BigInteger, uniformly distributed " +
+                        "over the range 0 to (2^N - 1), inclusive.")
+                    .examples(
+                        "(rand-bigint 256)")
+                    .seeAlso(
+                    	"rand-long",
+                    	"rand-double",
+                    	"rand-gaussian",
+                    	"bytebuf-allocate-random")
+                    .build()
+        ) {
+            @Override
+            public VncVal apply(final VncList args) {
+                ArityExceptions.assertArity(this, args, 1);
+
+                final long bits = Coerce.toVncLong(args.first()).getValue();
+
+                if (bits < 2 || bits > 65536) {
+                    throw new VncException(
+                            "Function 'rand-bigint': bits must be in the range [2..65536]");
+                }
+
+                return new VncBigInteger(new BigInteger((int)bits, random));
+            }
+
+            private static final long serialVersionUID = -1848883965231344442L;
+        };
+
     public static VncFunction zero_Q =
         new VncFunction(
                 "zero?",
@@ -2263,6 +2302,7 @@ private static VncVal median(final VncList sortedData) {
 
                     .add(rand_long)
                     .add(rand_double)
+                    .add(rand_bigint)
                     .add(rand_gaussian)
 
                     .add(range)