Struct fastrand::Rng

pub struct Rng(_);

A random number generator.

Implementations

impl Rng

pub fn new() -> Rng

Creates a new random number generator.

pub fn with_seed(seed: u64) -> Self

Creates a new random number generator with the initial seed.

pub fn alphabetic(&self) -> char

Generates a random char in ranges a-z and A-Z.

pub fn alphanumeric(&self) -> char

Generates a random char in ranges a-z, A-Z and 0-9.

pub fn bool(&self) -> bool

Generates a random bool.

pub fn digit(&self, base: u32) -> char

Generates a random digit in the given base.

Digits are represented by chars in ranges 0-9 and a-z.

Panics if the base is zero or greater than 36.

pub fn f32(&self) -> f32

Generates a random f32 in range 0..1.

pub fn f64(&self) -> f64

Generates a random f64 in range 0..1.

pub fn i8(&self, range: impl RangeBounds<i8>) -> i8

Generates a random i8 in the given range.

Panics if the range is empty.

pub fn i16(&self, range: impl RangeBounds<i16>) -> i16

Generates a random i16 in the given range.

Panics if the range is empty.

pub fn i32(&self, range: impl RangeBounds<i32>) -> i32

Generates a random i32 in the given range.

Panics if the range is empty.

pub fn i64(&self, range: impl RangeBounds<i64>) -> i64

Generates a random i64 in the given range.

Panics if the range is empty.

pub fn i128(&self, range: impl RangeBounds<i128>) -> i128

Generates a random i128 in the given range.

Panics if the range is empty.

pub fn isize(&self, range: impl RangeBounds<isize>) -> isize

Generates a random isize in the given range.

Panics if the range is empty.

pub fn lowercase(&self) -> char

Generates a random char in range a-z.

pub fn seed(&self, seed: u64)

Initializes this generator with the given seed.

pub fn get_seed(&self) -> u64

Gives back current seed that is being held by this generator.

pub fn shuffle<T>(&self, slice: &mut [T])

Shuffles a slice randomly.

pub fn fill(&self, slice: &mut [u8])

Fill a byte slice with random data.

pub fn u8(&self, range: impl RangeBounds<u8>) -> u8

Generates a random u8 in the given range.

Panics if the range is empty.

pub fn u16(&self, range: impl RangeBounds<u16>) -> u16

Generates a random u16 in the given range.

Panics if the range is empty.

pub fn u32(&self, range: impl RangeBounds<u32>) -> u32

Generates a random u32 in the given range.

Panics if the range is empty.

pub fn u64(&self, range: impl RangeBounds<u64>) -> u64

Generates a random u64 in the given range.

Panics if the range is empty.

pub fn u128(&self, range: impl RangeBounds<u128>) -> u128

Generates a random u128 in the given range.

Panics if the range is empty.

pub fn usize(&self, range: impl RangeBounds<usize>) -> usize

Generates a random usize in the given range.

Panics if the range is empty.

pub fn uppercase(&self) -> char

Generates a random char in range A-Z.

pub fn char(&self, range: impl RangeBounds<char>) -> char

Generates a random char in the given range.

Panics if the range is empty.

Trait Implementations

impl Clone for Rng

fn clone(&self) -> Rng

Clones the generator by deterministically deriving a new generator based on the initial seed.

Example

// Seed two generators equally, and clone both of them.
let base1 = fastrand::Rng::new();
base1.seed(0x4d595df4d0f33173);
base1.bool(); // Use the generator once.

let base2 = fastrand::Rng::new();
base2.seed(0x4d595df4d0f33173);
base2.bool(); // Use the generator once.

let rng1 = base1.clone();
let rng2 = base2.clone();

assert_eq!(rng1.u64(..), rng2.u64(..), "the cloned generators are identical");

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Rng

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Rng

fn default() -> Rng

Returns the “default value” for a type.

impl PartialEq<Rng> for Rng

fn eq(&self, other: &Rng) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Rng

impl StructuralEq for Rng

impl StructuralPartialEq for Rng