multirand 0.1.2

A threaded pseudo-random number generator
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
26

# multirand

A threaded prng. 

Adds a single struct `ThreadRandom` for generating random numbers. Each instance of `ThreadRandom` has it's own threaded randomiser, the goal being to avoid correlation between successive values by avoiding the use of successive values entirely.

This is not a cryptographically secure implementation of prng, nor is it a performant one. Non-threaded crates with better randomisation functions will work just as well if not better. This is largely a toy, vaguely inspired by the dedicated LFSR chips or processers used in games and computers in the early digital era. If you were to use it, it would in theory be best suited to situations where a "continuous trickle" of random numbers is required, as it will fail to build up entropy when polled continuously.

---

## Usage

Instance `ThreadRandom` in your project and poll it for random values:
```rust
use multirand::ThreadRandom;

let rand = ThreadRandom::os().unwrap();

fn randomised_behaviour() {
    /* --- snip --- */
    let tiebreaker = rand.random::<u8>().unwrap() % 4;
    
    if (tiebreaker == 0) { /* ... */
    /* --- snip --- */
}
```