Skip to content

stdlib/randomView source ↗

random

16 items · generated by scribe fromstdlib/random.fd· synced 2026-11-15

stdlib/random16 items

Contents

RngState

RNG state holder (LCG seed).

pub struct RngState {

Fields:

NameType
statei64

Defined at line 17


random_seed

Seed the random number generator.

Example: random_seed(42); var a = random_int(1000); random_seed(42); assert_eq(random_int(1000), a);

pub fn random_seed(seed: i64) -> void {

Parameters:

  • seed: i64

Returns: void

Defined at line 35


random_seed_time

Seed with current time (non-deterministic). Uses p_clock_now() for a time-based seed.

Example: random_seed_time(); var n = random_int(10); assert(n >= 0 && n < 10);

pub fn random_seed_time() -> void {

Returns: void

Defined at line 50


random_raw

Generate a random i64 in [0, RAND_MAX].

Example: random_seed(1); assert(random_raw() >= 0);

pub fn random_raw() -> i64 {

Returns: i64

Defined at line 72


random_int

Generate a random i64 in [0, max).

Example: random_seed(7); var i = 0; while i < 100 { var r = random_int(6); assert(r >= 0 && r < 6); i = i + 1; }

pub fn random_int(max: i64) -> i64 {

Parameters:

  • max: i64

Returns: i64

Defined at line 86


random_int_range

Generate a random i64 in [min, max].

Example: random_seed(7); var r = random_int_range(10, 20); assert(r >= 10 && r <= 20);

pub fn random_int_range(min: i64, max: i64) -> i64 {

Parameters:

  • min: i64
  • max: i64

Returns: i64

Defined at line 99


random_float

Generate a random f64 in [0.0, 1.0).

Example: random_seed(3); var f = random_float(); assert(f >= 0.0 && f < 1.0);

pub fn random_float() -> f64 {

Returns: f64

Defined at line 115


random_float_max

Generate a random f64 in [0.0, max).

Example: random_seed(3); var f = random_float_max(5.0); assert(f >= 0.0 && f < 5.0);

pub fn random_float_max(max: f64) -> f64 {

Parameters:

  • max: f64

Returns: f64

Defined at line 125


random_float_range

Generate a random f64 in [min, max).

Example: random_seed(3); var f = random_float_range(-1.0, 1.0); assert(f >= -1.0 && f < 1.0);

pub fn random_float_range(min: f64, max: f64) -> f64 {

Parameters:

  • min: f64
  • max: f64

Returns: f64

Defined at line 135


random_bool

Generate a random boolean.

Example: random_seed(9); var t = 0; var i = 0; while i < 100 { if random_bool() { t = t + 1; } i = i + 1; } assert(t > 0 && t < 100);

pub fn random_bool() -> bool {

Returns: bool

Defined at line 152


random_choice

Pick a random element from a Vec. Returns 0 if empty.

Example: random_seed(5); var v: Vec= Vec::new(); v.push(10); v.push(20); v.push(30); var c = random_choice(v); assert(c == 10 || c == 20 || c == 30);

pub fn random_choice(v: Vec<i64>) -> i64 {

Parameters:

  • v: Vec<i64>

Returns: i64

Defined at line 164


random_choice_idx

Pick a random index from a Vec of the given length.

Example: random_seed(5); var i = random_choice_idx(4); assert(i >= 0 && i < 4);

pub fn random_choice_idx(len: i64) -> i64 {

Parameters:

  • len: i64

Returns: i64

Defined at line 177


random_shuffle

Shuffle a Vec in place (Fisher-Yates).

Example: random_seed(11); var v: Vec= Vec::new(); v.push(1); v.push(2); v.push(3); v.push(4); random_shuffle(&mut v); assert_eq(v.len(), 4); assert_eq(v.get(0) + v.get(1) + v.get(2) + v.get(3), 10);

pub fn random_shuffle(v: & mut Vec<i64>) -> void {

Parameters:

  • v: & mut Vec<i64>

Returns: void

Defined at line 195


random_byte

Generate a random byte (0-255).

Example: random_seed(2); var b = random_byte(); assert(b >= 0 && b <= 255);

pub fn random_byte() -> i64 {

Returns: i64

Defined at line 212


random_hex

Generate a random hex string of the given length.

Example: random_seed(2); var h = random_hex(8); assert_eq(str_len(h), 8);

pub fn random_hex(length: i64) -> str {

Parameters:

  • length: i64

Returns: str

Defined at line 222


Generated by scribe, the Fides documentation generator