stdrandom 0.3.0-alpha.6

Generate random numbers using only Rust standard library
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# Generate random numbers using only standard library


[![License](https://img.shields.io/crates/l/stdrandom)](https://unlicense.org)
[![Crates.io](https://img.shields.io/crates/v/stdrandom.svg)](https://crates.io/crates/stdrandom)
[![Crates.io MSRV](https://img.shields.io/crates/msrv/stdrandom?logo=rust&label=MSRV&labelColor=orange)](https://blog.rust-lang.org/2021/10/21/Rust-1.56.0/)
[![Documentation](https://docs.rs/stdrandom/badge.svg)](https://docs.rs/stdrandom)
[![Downloads](https://img.shields.io/crates/d/stdrandom)](https://crates.io/crates/stdrandom/versions)

## Overview

This Rust crate provides various **random number generation utilities**, including:
- Random **u8,u16,u32,u64,u128** generation.
- Non negative **i8,i16,i32,i64,i128** generation
- **Floating-point randomness** (`f32` and `f64`) in `[0,1)`.
- Random **byte filling** for buffers.
- Random **range filling** for slices.
- Random number generation from **Range**.
- **High entropy** random number generation by using separate thread `RandomState`.
- **Fast** but lower-entropy alternatives using thread local `RandomState`.

## Features

- Minimal supported Rust version **1.56**. Entire *2018 Rust edition* is supported.
- *No external dependencies* beyond standard Rust library.
- **Thread-based randomness**: Uses separate threads for improved entropy (`random_u64()`).
- **Secure and fast implementations** for generating random numbers.
- **Uniform distribution** ensured for floating-point values.

## Functions returning random numbers


### `random_u128(), random_u64(), random_u32(), random_u16(), random_u8(), random_usize()`

Generates a unsigned **high entropy random** number in a separate thread.
These numbers have uniform distribution and pass chi square test.

### `fast_u128(), fast_u64(), fast_u32(), fast_u16(), fast_u8(), fast_usize()`

Generates a **lower entropy random** number from current thread.

### `random_f64(), random_f32()`

Generates a **high entropy random** floating point number in a separate thread
from in \[0, 1\) range. These numbers have uniform distribution
and pass chi square test.

### `fast_f32(), fast_f64()`

Generates a **lower entropy random** floating point number in \[0, 1\).

## Helper Functions


### `fill_bytes(), fill_numbers()`

Fills slice with random numbers with provided generator.

### `gen_range(), fill_range()`

Generate random number from specified range.

## No copyright

This code is released under a "No Copyright" license.

You may use, modify, distribute, and contribute to this code without restriction.
To the extent possible under law, the author(s) of this work waive all copyright and related rights.

Licensed under CC0-1.0 OR Unlicense.