hyper-thread-random 0.4.2

Provides hyper-thread local random number generators optimized for recent Intel x86-64 chips with the `RDRAND` instruction; falls back to rand crate for others.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

// This file is part of hyper-thread-random. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/hyper-thread-random/master/COPYRIGHT. No part of hyper-thread-random, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2018 The developers of hyper-thread-random. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/hyper-thread-random/master/COPYRIGHT.


/// Generates a random u32 for the current hyper thread.
#[cfg(all(target_arch = "x86", target_feature = "rdrand"))]
#[inline(always)]
pub fn generate_hyper_thread_safe_random_u32() -> u32
{
	generate!(u32, ::std::arch::x86::_rdrand32_step)
}

/// Generates a random u32 for the current hyper thread.
#[cfg(all(target_arch = "x86_64", target_feature = "rdrand"))]
#[inline(always)]
pub fn generate_hyper_thread_safe_random_u32() -> u32
{
	generate!(u32, ::std::arch::x86_64::_rdrand32_step)
}

/// Generates a random u32 for the current hyper thread.
#[cfg(not(all(any(target_arch = "x86", target_arch = "x86_64"), target_feature = "rdrand")))]
pub fn generate_hyper_thread_safe_random_u32() -> u32
{
	thread_rng().next_u32()
}