IRandomSource<TGenerator> Interface

public interface IRandomSource<TGenerator> : IRandomSource, 
	IStateful
where TGenerator : struct, new(), IRandomGenerator

Public Interface IRandomSource(Of TGenerator As {Structure, New, IRandomGenerator})
	Inherits IRandomSource, IStateful

generic<typename TGenerator>
where TGenerator : value class, gcnew(), IRandomGenerator
public interface class IRandomSource : IRandomSource, 
	IStateful

type IRandomSource<'TGenerator when 'TGenerator : struct, new() and IRandomGenerator> = 
    interface
        interface IRandomSource
        interface IStateful
    end

Implements

IRandomSource, IStateful

Type Parameters

TGenerator

The underlying generator type of the random source, used to enable optimizations like inlining. Must be a struct implementing IRandomGenerator.

IRandomSource<TGenerator> extends IRandomSource with typed access to the underlying Layer 2 generator struct. This enables:

• Zero-overhead hot paths: Numerics.NET algorithms can obtain a ref to the generator once and operate directly on the struct, enabling full inlining and specialization by the JIT compiler.
• No per-sample virtual dispatch: Hot-path operations avoid interface calls by working with concrete generator structs.
• Generic constraint-based specialization: Algorithms can use where TRng : IRandomSource<TGenerator> to access typed generators while remaining algorithm-agnostic.

Usage Pattern:

Performance-critical Numerics.NET APIs should accept IRandomSource<TGenerator> and extract the generator reference immediately:

Implementation Requirements:

• The Generator property must return a ref to the stored generator instance. It must never return a copy.
• All IRandomSource API methods should delegate to the generator to ensure consistent behavior.

Reference