ScalarGenerator64<TEngine> Structure

public struct ScalarGenerator64<TEngine> : IRandomGenerator, 
	IStateful
where TEngine : struct, new(), IScalarEngine<ulong>, IStateful

Public Structure ScalarGenerator64(Of TEngine As {Structure, New, IScalarEngine(Of ULong), IStateful})
	Implements IRandomGenerator, IStateful

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

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

Inheritance

Object  →  ValueType  →  ScalarGenerator64<TEngine>

Implements

IRandomGenerator, IStateful

Type Parameters

TEngine

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

ScalarGenerator64<TEngine> wraps a scalar 64-bit engine and provides:

• NextUInt64(): Returns the next word from the engine via engine.Next().
• 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.

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 plus the cached uint (4 bytes LE) and cache flag (1 byte).

Reference