Coverage Report

Created: 2026-04-01 06:59

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/rust/registry/src/index.crates.io-1949cf8c6b5b557f/getrandom-0.4.2/src/sys_rng.rs
Line
Count
Source
1
use crate::Error;
2
use rand_core::{TryCryptoRng, TryRng};
3
4
/// A [`TryRng`] interface over the system's preferred random number source
5
///
6
/// This is a zero-sized struct. It can be freely constructed with just `SysRng`.
7
///
8
/// This struct is also available as [`rand::rngs::SysRng`] when using [rand].
9
///
10
/// # Usage example
11
///
12
/// `SysRng` implements [`TryRng`]:
13
/// ```
14
/// use getrandom::{rand_core::TryRng, SysRng};
15
///
16
/// let mut key = [0u8; 32];
17
/// SysRng.try_fill_bytes(&mut key).unwrap();
18
/// ```
19
///
20
/// Using it as an [`Rng`] is possible using [`UnwrapErr`]:
21
/// ```
22
/// use getrandom::rand_core::{Rng, UnwrapErr};
23
/// use getrandom::SysRng;
24
///
25
/// let mut rng = UnwrapErr(SysRng);
26
/// let random_u64 = rng.next_u64();
27
/// ```
28
///
29
/// [rand]: https://crates.io/crates/rand
30
/// [`rand::rngs::SysRng`]: https://docs.rs/rand/latest/rand/rngs/struct.SysRng.html
31
/// [`Rng`]: rand_core::Rng
32
/// [`UnwrapErr`]: rand_core::UnwrapErr
33
#[derive(Clone, Copy, Debug, Default)]
34
pub struct SysRng;
35
36
impl TryRng for SysRng {
37
    type Error = Error;
38
39
    #[inline]
40
0
    fn try_next_u32(&mut self) -> Result<u32, Error> {
41
0
        crate::u32()
42
0
    }
43
44
    #[inline]
45
0
    fn try_next_u64(&mut self) -> Result<u64, Error> {
46
0
        crate::u64()
47
0
    }
48
49
    #[inline]
50
0
    fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error> {
51
0
        crate::fill(dest)
52
0
    }
Unexecuted instantiation: <getrandom::sys_rng::SysRng as rand_core::TryRng>::try_fill_bytes
Unexecuted instantiation: <getrandom::sys_rng::SysRng as rand_core::TryRng>::try_fill_bytes
53
}
54
55
impl TryCryptoRng for SysRng {}