spinoso_random/random/
rand.rs

1use rand_core::{RngCore, SeedableRng};
2
3use super::{DEFAULT_SEED_BYTES, Mt, Random, seed_to_key};
4
5impl SeedableRng for Random {
6    type Seed = [u8; DEFAULT_SEED_BYTES];
7
8    /// Reseed from four `u32`s.
9    ///
10    /// # Examples
11    ///
12    /// ```
13    /// use rand_core::{RngCore, SeedableRng};
14    /// use spinoso_random::Random;
15    ///
16    /// // Default MT seed
17    /// let seed = 5489_u128.to_le_bytes();
18    /// let mut mt = Random::from_seed(seed);
19    /// assert_ne!(mt.next_u32(), mt.next_u32());
20    /// ```
21    #[inline]
22    fn from_seed(seed: Self::Seed) -> Self {
23        let seed = seed_to_key(seed);
24        let mt = Mt::new_with_key(seed.iter().copied());
25        Self {
26            mt,
27            seed: seed.to_vec(),
28        }
29    }
30}
31
32impl RngCore for Random {
33    /// Generate next `u64` output.
34    ///
35    /// This function is implemented by generating two `u32`s from the RNG and
36    /// shifting + masking them into a `u64` output.
37    ///
38    /// # Examples
39    ///
40    /// ```
41    /// use rand_core::RngCore;
42    /// use spinoso_random::Random;
43    ///
44    /// let mut random = Random::with_seed(33);
45    /// assert_ne!(random.next_u64(), random.next_u64());
46    /// ```
47    #[inline]
48    fn next_u64(&mut self) -> u64 {
49        self.mt.next_u64()
50    }
51
52    /// Generate next `u32` output.
53    ///
54    /// `u32` is the native output of the generator. This function advances the
55    /// RNG step counter by one.
56    ///
57    /// # Examples
58    ///
59    /// ```
60    /// use rand_core::RngCore;
61    /// use spinoso_random::Random;
62    ///
63    /// let mut random = Random::with_seed(33);
64    /// assert_ne!(random.next_u32(), random.next_u32());
65    /// ```
66    #[inline]
67    fn next_u32(&mut self) -> u32 {
68        self.mt.next_u32()
69    }
70
71    /// Fill a buffer with bytes generated from the RNG.
72    ///
73    /// This method generates random `u32`s (the native output unit of the RNG)
74    /// until `dest` is filled.
75    ///
76    /// This method may discard some output bits if `dest.len()` is not a
77    /// multiple of 4.
78    ///
79    /// # Examples
80    ///
81    /// ```
82    /// use rand_core::RngCore;
83    /// use spinoso_random::Random;
84    ///
85    /// let mut random = Random::with_seed(33);
86    /// let mut buf = [0; 32];
87    /// random.fill_bytes(&mut buf);
88    /// assert_ne!([0; 32], buf);
89    /// let mut buf = [0; 31];
90    /// random.fill_bytes(&mut buf);
91    /// assert_ne!([0; 31], buf);
92    /// ```
93    #[inline]
94    fn fill_bytes(&mut self, dest: &mut [u8]) {
95        self.mt.fill_bytes(dest);
96    }
97}
spinoso_random/random/rand.rs

spinoso_random/random/
rand.rs
