IRandomGenerator Interface

public interface IRandomGenerator : IStateful

Public Interface IRandomGenerator
	Inherits IStateful

public interface class IRandomGenerator : IStateful

type IRandomGenerator = 
    interface
        interface IStateful
    end

Implements

IStateful

This interface defines the minimal primitive API for random number generation:

• NextUInt32(): Generates a 32-bit unsigned integer.
• NextUInt64(): Generates a 64-bit unsigned integer.
• NextBytes(Span<Byte>): Fills a span with random bytes in little-endian order.

Little-Endian Promise:

All bytes written by NextBytes(Span<Byte>) are written in little-endian order, ensuring portable and predictable byte sequences across all platforms.

Tail Consumption Rule:

When NextBytes(Span<Byte>) ends with a remainder smaller than the generator's natural word write size, it consumes one additional word and writes only the required low-order bytes.

Reference