#random #rng

no-std rand_core

Core random number generator traits and tools for implementation

10 unstable releases (4 breaking)

0.4.0 Jan 25, 2019
0.3.0 Sep 24, 2018
0.2.1 Jun 8, 2018
0.1.0-pre.0 Mar 23, 2018
0.0.1 Sep 14, 2017

#2 in Algorithms

Download history 87238/week @ 2018-12-20 90892/week @ 2018-12-27 115524/week @ 2019-01-03 116679/week @ 2019-01-10 129126/week @ 2019-01-17 168824/week @ 2019-01-24 172489/week @ 2019-01-31 181779/week @ 2019-02-07 179430/week @ 2019-02-14 187107/week @ 2019-02-21 189426/week @ 2019-02-28 187175/week @ 2019-03-07 182096/week @ 2019-03-14 170153/week @ 2019-03-21 176719/week @ 2019-03-28

455,441 downloads per month
Used in 8,029 crates (44 directly)

MIT/Apache

55KB
638 lines

rand_core

Build Status Build Status Latest version Book API API Minimum rustc version

Core traits and error types of the rand library, plus tools for implementing RNGs.

This crate is intended for use when implementing the core trait, RngCore; it defines the core traits to be implemented as well as several small functions to aid in their implementation and types required for error handling.

The main rand crate re-exports most items defined in this crate, along with tools to convert the integer samples generated by RngCore to many different applications (including sampling from restricted ranges, conversion to floating point, list permutations and secure initialisation of RNGs). Most users should prefer to use the main rand crate.

Links:

Functionality

The rand_core crate provides:

  • base random number generator traits
  • error-reporting types
  • functionality to aid implementation of RNGs

The traits and error types are also available via rand.

Crate Features

rand_core supports no_std and alloc-only configurations, as well as full std functionality. The differences between no_std and full std are small, comprising RngCore support for Box<R> types where R: RngCore, std::io::Read support for types supporting RngCore, and extensions to the Error type's functionality.

The std feature is not enabled by default. This is primarily to avoid build problems where one crate implicitly requires rand_core with std support and another crate requires rand without std support. However, the rand crate continues to enable std support by default, both for itself and rand_core.

The serde1 feature can be used to derive Serialize and Deserialize for RNG implementations that use the BlockRng or BlockRng64 wrappers.

License

rand_core is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT, and COPYRIGHT for details.

Dependencies

~202KB