IRandomSource Interface

public interface IRandomSource : IStateful

Public Interface IRandomSource
	Inherits IStateful

public interface class IRandomSource : IStateful

type IRandomSource = 
    interface
        interface IStateful
    end

Implements

IStateful

IRandomSource defines the high-level API for random number generation that is expected by Numerics.NET's algorithms and distributions. It provides:

• Standard integer generation: Next(), Next(Int32), Next(Int32, Int32)
• 64-bit integer generation: NextInt64(), NextInt64(Int64), NextInt64(Int64, Int64)
• Floating-point generation: NextDouble(), NextSingle()
• Byte buffer filling: NextBytes(Byte[]), NextBytes(Span<Byte>)
• Primitive unsigned generation: NextUInt32(), NextUInt64()

Metadata:

Implementations must provide metadata describing the generator's characteristics:

• Name: A human-readable name for the generator (e.g., "Pcg64", "Xoshiro256**")
• BitsPerWord: The native word size (32 or 64) of the underlying generator

Usage in Numerics.NET:

Higher-level Numerics.NET APIs accept IRandomSource when they need a general-purpose RNG abstraction. For performance-critical hot paths, prefer IRandomSource<TGenerator> which provides typed access to the underlying Layer 2 generator for zero-overhead operation.

Reference