BlockGenerator64<TEngine> Structure

public struct BlockGenerator64<TEngine> : IRandomGenerator, 
	IStateful
where TEngine : struct, new(), IBlockEngine<ulong>, IStateful

Public Structure BlockGenerator64(Of TEngine As {Structure, New, IBlockEngine(Of ULong), IStateful})
	Implements IRandomGenerator, IStateful

generic<typename TEngine>
where TEngine : value class, gcnew(), IBlockEngine<unsigned long long>, IStateful
public value class BlockGenerator64 : IRandomGenerator, 
	IStateful

[<SealedAttribute>]
type BlockGenerator64<'TEngine when 'TEngine : struct, new() and IBlockEngine<uint64> and IStateful> = 
    struct
        inherit ValueType
        interface IRandomGenerator
        interface IStateful
    end

Inheritance

Object  →  ValueType  →  BlockGenerator64<TEngine>

Implements

IRandomGenerator, IStateful

Type Parameters

TEngine

The engine type, which must be a struct implementing IBlockEngine<T> for UInt64 and IStateful.

BlockGenerator64<TEngine> wraps a non-counter 64-bit block engine and provides:

• NextUInt64(): Returns the next word from the current block via engine.Output(index).
• NextUInt32(): Uses caching to split 64-bit words into two 32-bit words.
• NextBytes(Span<Byte>): Writes bytes via NextUInt32() in 4-byte chunks (little-endian), with tail handling.

Refill Policy (Advance-on-Empty):

When the block is exhausted (_index == BlockLength), the generator calls engine.AdvanceBlock() to move to the next block and resets _index = 0.

Uint Caching:

When NextUInt32() is called, if no cached value exists, the generator calls NextUInt64(), returns the low 32 bits, and caches the high 32 bits for the next call.

State Persistence:

Layer 2 state includes engine state, cursor index (4 bytes LE), cached uint (4 bytes LE), and cache flag (1 byte).

Reference