deterministic_rand 0.9.0

Hierarchical random number generators for concurrent simulations with switchable determinism.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

//!
//! The most trivial use case. Just generating a random number.
//!

// `Rng`` is re-exported from `rand` and `Hrng` stands for hierarchical random number generators.
#[ cfg(not(feature = "no_std")) ]
use deterministic_rand :: { Rng, Hrng };

fn main() 
{
  #[ cfg(not(feature = "no_std")) ]
  {
  // Make master random number generator with a seed.
  let hrng = Hrng ::master_with_seed("master1".into());
  // Get a reference to the current random number generator using a reference counter and mutex.
  let rng_ref = hrng.rng_ref();
  // Lock it producing a guard.
  let mut rng = rng_ref.lock().unwrap();
  // Generate a number.
  let _got: u64 = rng.gen();
  // If determinism is enabled then sequence of generated rundom numbers will be the same.
  #[ cfg(feature = "determinism") ]
  assert_eq!(_got, 6165676721551962567);
 }
}