Make default state public (nim-lang#15763)

* Make default state public * Address review comments Co-authored-by: b3liever <[email protected]>
mildred · Jan 11, 2021 · 4630541 · 4630541
1 parent 0348179
commit 4630541
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 1 deletion.
diff --git a/changelog.md b/changelog.md
@@ -7,7 +7,7 @@
 - `prelude` now works with the JavaScript target.
 
 - Added `ioutils` module containing `duplicate` and `duplicateTo` to duplicate `FileHandle` using C function `dup` and `dup2`.
-
+- Added `randState` template that exposes the default random number generator. Useful for library authors.
 
 ## Language changes
 

diff --git a/lib/pure/random.nim b/lib/pure/random.nim
@@ -119,6 +119,12 @@ else:
     a0: 0x69B4C98CB8530805u64,
     a1: 0xFED1DD3004688D67CAu64) # global for backwards compatibility
 
+since (1, 5):
+  template randState*(): untyped =
+    ## Makes the default Rand state accessible from other modules.
+    ## Useful for module authors.
+    state
+
 proc rotl(x, k: Ui): Ui =
   result = (x shl k) or (x shr (Ui(64) - k))