stdrandom 0.3.0-alpha.1

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

# Generate Random numbers using 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 **u32 and u64** generation.
- **Floating-point randomness** (`f32` and `f64`) in `[0,1)`.
- Random **byte filling** for buffers.
- Random number from **Range**
- **Fast** but lower-entropy alternatives using thread local `RandomState`.

## Features

- Minimal supported Rust version **1.56**
- 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_u64(), random_u32()`

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

### `fast_u64(), fast_u32()`

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()`

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.