Xoshiro256StarStar Class

Represents a pseudo-random number generator based on the Xoshiro256** algorithm.

Definition

Namespace: Numerics.NET.Random
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.3.0

public sealed class Xoshiro256StarStar : RandomSource<ScalarGenerator64<Xoshiro256StarStarEngine>>, 
	IRandomSourceFactory<Xoshiro256StarStar>, IAdvanceable, IJumpable

Visual Basic

Public NotInheritable Class Xoshiro256StarStar
	Inherits RandomSource(Of ScalarGenerator64(Of Xoshiro256StarStarEngine))
	Implements IRandomSourceFactory(Of Xoshiro256StarStar), IAdvanceable, 
	IJumpable

C++/CLI

public ref class Xoshiro256StarStar sealed : public RandomSource<ScalarGenerator64<Xoshiro256StarStarEngine>>, 
	IRandomSourceFactory<Xoshiro256StarStar^>, IAdvanceable, IJumpable

[<SealedAttribute>]
type Xoshiro256StarStar = 
    class
        inherit RandomSource<ScalarGenerator64<Xoshiro256StarStarEngine>>
        interface IRandomSourceFactory<Xoshiro256StarStar>
        interface IAdvanceable
        interface IJumpable
    end

Inheritance: Object → RandomSource<ScalarGenerator64<Xoshiro256StarStarEngine>> → Xoshiro256StarStar

Implements: IAdvanceable, IJumpable, IRandomSourceFactory<Xoshiro256StarStar>

Remarks

Use the Xoshiro256StarStar class to represent a pseudo-random number generator that uses the Xoshiro256** algorithm by David Blackman and Sebastiano Vigna.

This generator has a period of 2²⁵⁶ - 1 and passes all statistical tests. It is the default 64-bit generator in .NET 6+ and is one of the fastest high-quality generators.

The "**" scrambler makes it suitable for general-purpose use. For floating-point generation, consider using Xoshiro256Plus.

Reference: David Blackman and Sebastiano Vigna. "Scrambled Linear Pseudorandom Number Generators." ACM Trans. Math. Softw. 2021.

Example

var rng = new Xoshiro256StarStar(123);
int n = rng.Next(100);
rng.Jump();

Constructors

Xoshiro256StarStar()	Constructs a new Xoshiro256** random number generator with a cryptographically generated seed.
Xoshiro256StarStar(RandomOptions)	Constructs a new Xoshiro256** random number generator with advanced options.
Xoshiro256StarStar(ReadOnlySpan<Byte>)	Constructs a new Xoshiro256** random number generator from saved state.
Xoshiro256StarStar(Int64, SeedProfile)	Constructs a new Xoshiro256** with the specified seed and seed profile.
Xoshiro256StarStar(ReadOnlySpan<UInt64>, SeedProfile)	Constructs a new Xoshiro256** with the specified seed array and seed profile.
Xoshiro256StarStar(Int64, StreamAddress, SeedProfile)	Constructs a new Xoshiro256** random number generator with the specified seed.
Xoshiro256StarStar(ReadOnlySpan<UInt64>, StreamAddress, SeedProfile)	Constructs a new Xoshiro256** random number generator with a seed array.
Xoshiro256StarStar(UInt64, UInt64, UInt64, UInt64)	Initializes a new instance of the Xoshiro256StarStar class with direct state initialization.

Properties

BitsPerWord	Gets the number of bits per word in the generator's native output. (Overrides RandomSource<TGenerator>.BitsPerWord)
Name	Gets a human-readable name for this random number generator. (Overrides RandomSource<TGenerator>.Name)
StateSize	Gets the number of bytes required to save/load this generator's state. (Inherited from RandomSource<TGenerator>)
Uncached	Gets an uncached facade for this random number generator. (Inherited from RandomSource<TGenerator>)

Methods

Advance	Advances the generator state by the specified number of steps.
Copy	Creates an exact copy of this generator with the same state.
Create	Creates a new Xoshiro256StarStar instance from the specified options.
CreateStreamPartition	Creates a jump-based stream partition for generating independent RNG streams.
CreateStreamTree	Creates a hierarchical stream tree for generating independent RNG streams.
Equals	Determines whether the specified object is equal to the current object. (Inherited from Object)
Fill(Span<UInt32>)	Fills a span with random 32-bit unsigned integer values. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int32>, Int32)	Fills a span with random 32-bit signed integers less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int64>, Int64)	Fills a span with random 64-bit signed integers less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int32>, Int32, Int32)	Fills a span with random 32-bit signed integers within a specified range. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int64>, Int64, Int64)	Fills a span with random 64-bit signed integers within a specified range. (Inherited from RandomSource<TGenerator>)
GetHashCode	Serves as the default hash function. (Inherited from Object)
GetState	Returns the current state of the generator as a byte array. (Inherited from RandomSource<TGenerator>)
GetType	Gets the Type of the current instance. (Inherited from Object)
Jumped	Returns a new instance of the random number generator that is advanced by a specified number of jumps in the sequence.
LoadState	Loads the generator's state from the source span in a stable little-endian format. (Inherited from RandomSource<TGenerator>)
LongJumped	Returns a new instance of the random number generator that is advanced by a specified number of long jumps in the sequence.
Next()	Returns a non-negative random integer. (Inherited from RandomSource<TGenerator>)
Next(Int32)	Returns a non-negative random integer less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Next(Int32, Int32)	Returns a random integer within a specified range. (Inherited from RandomSource<TGenerator>)
NextBytes(Byte[])	Fills the elements of a specified array of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Span<Byte>)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Byte[], Boolean)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Span<Byte>, Boolean)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextDouble	Returns a random floating-point number in the range [0.0, 1.0). (Inherited from RandomSource<TGenerator>)
NextInt64()	Returns a non-negative random 64-bit integer. (Inherited from RandomSource<TGenerator>)
NextInt64(Int64)	Returns a non-negative random 64-bit integer less than the specified maximum. (Inherited from RandomSource<TGenerator>)
NextInt64(Int64, Int64)	Returns a random 64-bit integer within a specified range. (Inherited from RandomSource<TGenerator>)
NextSingle	Returns a random single-precision floating-point number in the range [0.0, 1.0). (Inherited from RandomSource<TGenerator>)
NextUInt32	Returns a random 32-bit unsigned integer. (Inherited from RandomSource<TGenerator>)
NextUInt64	Returns a random 64-bit unsigned integer. (Inherited from RandomSource<TGenerator>)
Reinitialize	Reinitializes this random number generator using the specified initialization options. (Inherited from RandomSource<TGenerator>)
SaveState	Saves the generator's state to the destination span in a stable little-endian format. (Inherited from RandomSource<TGenerator>)
ToString	Returns a string that represents the current object. (Inherited from Object)