Skip to main content

cubecl_common/
rand.rs

1pub use rand::{RngExt, SeedableRng, rngs::StdRng};
2
3use rand::distr::StandardUniform;
4use rand::prelude::Distribution;
5
6/// Returns a seeded random number generator using entropy.
7#[cfg(feature = "std")]
8#[inline(always)]
9pub fn get_seeded_rng() -> StdRng {
10    use rand::rngs::SysRng;
11
12    StdRng::try_from_rng(&mut SysRng).unwrap()
13}
14
15/// Returns a seeded random number generator using a pre-generated seed.
16#[cfg(not(feature = "std"))]
17#[inline(always)]
18pub fn get_seeded_rng() -> StdRng {
19    const CONST_SEED: u64 = 42;
20    StdRng::seed_from_u64(CONST_SEED)
21}
22
23/// Generates random data from a thread-local RNG.
24#[cfg(feature = "std")]
25#[inline]
26pub fn gen_random<T>() -> T
27where
28    StandardUniform: Distribution<T>,
29{
30    rand::rng().random()
31}
32
33/// Generates random data from a mutex-protected RNG.
34#[cfg(not(feature = "std"))]
35#[inline]
36pub fn gen_random<T>() -> T
37where
38    StandardUniform: Distribution<T>,
39{
40    use crate::stub::Mutex;
41    static RNG: Mutex<Option<StdRng>> = Mutex::new(None);
42    let mut rng = RNG.lock().unwrap();
43    if rng.is_none() {
44        *rng = Some(get_seeded_rng());
45    }
46    rng.as_mut().unwrap().random()
47}