Struct std::random::Pcg32

PCG-32 random number generator

A small-state general purpose random number generator (https://www.pcg-random.org/).

Not suitable for cryptographic purposes.

Fields

• state: u64

• increment: u64

Methods

• fn from_seed(seed: &[u8; 16]) -> Pcg32

  source

  Create a Pcg32 random number generator from a given seed.

• fn next_u32(self: &mut Pcg32) -> u32

  source

  Generate a 32-bit integer.

• fn next_u64(self: &mut Pcg32) -> u64

  source

  Generate a 64-bit integer.

Mixins

• mixin Rng<Pcg32>

• fn fill_bytes(self: &mut Self, dest: &mut [u8])

  source

  Fill the slice with random bytes.

• mixin RngExt<Pcg32>

• fn next<T, R>(rng: &mut Self, range: R) -> T

  T: Integer

  R: RangeOf<T>

  source

  Generate a random number in a given integer range.

  All range types are supported.

  Example

  use std::random::thread_rng;
  
  let value: i32 = thread_rng().next(0..3);
  assert!(value >= 0 && value < 3);
  
  let value: i32 = thread_rng().next(0..=3);
  assert!(value >= 0 && value <= 3);
  
  let value: i32 = thread_rng().next(..3);
  assert!(value < 3);
  
  let value: i32 = thread_rng().next(..=3);
  assert!(value <= 3);
  
  let value: i32 = thread_rng().next(3..);
  assert!(value >= 3);
  
  let value: i32 = thread_rng().next(..);
  // Any possible value of i32
  Run this example

• fn next_float<T>(rng: &mut Self) -> T

  T: FloatingPoint

  source

  Generate a random floating point number in [0, 1) interval.

  This is equivalent to sampling from StandardFloat distribution.

  Example

  use std::random::thread_rng;
  
  let value: f64 = thread_rng().next_float();
  
  assert!(value >= 0.0 && value < 1.0);
  Run this example

• fn shuffle<T>(rng: &mut Self, slice: &mut [T])

  source

  Permute a slice of elements in random order.

  Example

  use std::random::thread_rng;
  
  let values = [1, 2, 3, 4, 5];
  thread_rng().shuffle(&values);
  
  for value in values {
      println!("{}", value);
  }
  Run this example

• fn choice<T>(rng: &mut Self, slice: &[T]) -> T

  source

  Return a random element of the slice.

  Example

  use std::random::thread_rng;
  
  let value = thread_rng().choice(&["hello", "world"]);
  
  assert!(value == "hello" || value == "world");
  Run this example