GeneralLinearCongruentialGenerator128

Struct GeneralLinearCongruentialGenerator128 

Source
pub struct GeneralLinearCongruentialGenerator128<const A: u128, const C: u128> { /* private fields */ }
Expand description

The general linear congruential generator. Internally it holds u128 state and follows the next_state = A*old_state + C formula (over 128-bit modulo arithmetic).

Additionally all LCGs implement Splittable through an ad-hoc method. However users should be warned that statistical properties of this method are barely verified.

Implementations§

Source§

impl<const A: u128, const C: u128> GeneralLinearCongruentialGenerator128<A, C>

Source

pub const fn next(&mut self) -> u128

Generates a new pseudo-random u128 value.

Trait Implementations§

Source§

impl<const A: u128, const C: u128> Clone for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn clone(&self) -> GeneralLinearCongruentialGenerator128<A, C>

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<const A: u128, const C: u128> Debug for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for f32

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for f64

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i32

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i64

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u32

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const A: u128, const C: u128> PRNConcreteBoundedGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u64

Source§

fn generate<TBounds: RangeBounds<Self>>( generator: &mut GeneralLinearCongruentialGenerator128<A, C>, range: TBounds, ) -> Self

Generates a new pseudo random instance of itself in given range.
Source§

impl<const N: usize, const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for [u8; N]

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for bool

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i128

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i32

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i64

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for i8

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u128

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u32

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u64

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNConcreteGenerator<GeneralLinearCongruentialGenerator128<A, C>> for u8

Source§

fn generate(generator: &mut GeneralLinearCongruentialGenerator128<A, C>) -> Self

Generates a new pseudo random instance of itself.
Source§

impl<const A: u128, const C: u128> PRNGSerialize for GeneralLinearCongruentialGenerator128<A, C>

Source§

const MAX_SERIALIZED_SIZE: usize = 20usize

The maximum size of serialized value, in bytes. This should be used by callers to determine how big the buffer needs to be for PRNGSerialize::serialize to succeed. Read more
Source§

type SerializeError = SerializeError

Concrete serialization error.
Source§

type DeserializeError = DeserializeError

Concrete deserialization error.
Source§

fn serialize(&self, buffer: &mut [u8]) -> Result<usize, Self::SerializeError>

Serializes self into the buffer. Returns the actual amount of bytes that were written on success. Read more
Source§

fn deserialize( buffer: &[u8], ) -> Result<DeserializationResult<Self>, Self::DeserializeError>

Deserializes self from the passed buffer. Returns deserialization info on success, i.e. the actual value and the amount of bytes read from the buffer. Read more
Source§

impl<const A: u128, const C: u128> PRNGenerator for GeneralLinearCongruentialGenerator128<A, C>

Source§

unsafe fn fill_raw(&mut self, dst_ptr: *mut u8, dst_len: usize)

Fills the given raw buffer with randomness. Read more
Source§

fn fill(&mut self, dst: &mut [u8])

Fills the given buffer with randomness.
Source§

fn generate<T>(&mut self) -> T
where T: PRNConcreteGenerator<Self>,

Generates pseudo random instance of given type if supported. This function should support at least i32, u32, i64 and u64 types.
Source§

fn generate_in_range<T, TBounds: RangeBounds<T>>(&mut self, range: TBounds) -> T

Generates a pseudo random number in given range, if supported.
Source§

impl<const A: u128, const C: u128> PartialEq for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn eq(&self, other: &GeneralLinearCongruentialGenerator128<A, C>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<const A: u128, const C: u128> ReprC for GeneralLinearCongruentialGenerator128<A, C>

Source§

const CHECK: ()

This field is used for const checks only.
Source§

impl<const A: u128, const C: u128> Seedable<u128> for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn with_seed(seed: u128) -> Self

Creates a new instance from a given seed.
Source§

impl<const A: u128, const C: u128> Seedable<u64> for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn with_seed(seed: u64) -> Self

Creates a new instance from a given seed.
Source§

impl<const A: u128, const C: u128> Splittable for GeneralLinearCongruentialGenerator128<A, C>

Source§

fn split(&mut self) -> Self

Create a new PRNG from the current one. In a deterministic, yet non-obvious (pseudo random) way.
Source§

impl<const A: u128, const C: u128> Copy for GeneralLinearCongruentialGenerator128<A, C>

Source§

impl<const A: u128, const C: u128> Eq for GeneralLinearCongruentialGenerator128<A, C>

Source§

impl<const A: u128, const C: u128> StructuralPartialEq for GeneralLinearCongruentialGenerator128<A, C>

Auto Trait Implementations§

§

impl<const A: u128, const C: u128> Freeze for GeneralLinearCongruentialGenerator128<A, C>

§

impl<const A: u128, const C: u128> RefUnwindSafe for GeneralLinearCongruentialGenerator128<A, C>

§

impl<const A: u128, const C: u128> Send for GeneralLinearCongruentialGenerator128<A, C>

§

impl<const A: u128, const C: u128> Sync for GeneralLinearCongruentialGenerator128<A, C>

§

impl<const A: u128, const C: u128> Unpin for GeneralLinearCongruentialGenerator128<A, C>

§

impl<const A: u128, const C: u128> UnwindSafe for GeneralLinearCongruentialGenerator128<A, C>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.