CounterBasedRandomSource<TGenerator, TWord>.AdvanceBlock Method

public void AdvanceBlock(
	ulong blockCount
)

Public Sub AdvanceBlock ( 
	blockCount As ULong
)

public:
virtual void AdvanceBlock(
	unsigned long long blockCount
) sealed

abstract AdvanceBlock : 
        blockCount : uint64 -> unit 
override AdvanceBlock : 
        blockCount : uint64 -> unit 

Parameters

blockCount  UInt64

The number of blocks to advance. Each block corresponds to BlockLength output values.

Implements

This method increments the counter by blockCount in counter space, performing proper carry propagation for multi-word counters. This provides O(1) skip-ahead capability.

This operation is an overload of the single-step AdvanceBlock() method, allowing efficient advancement by multiple blocks.

Consistency:

After calling AdvanceBlock(UInt64), implementations may either regenerate the block (leaving the engine consistent) or leave the block stale (leaving the engine inconsistent). Callers should assume the engine is inconsistent after this call and invoke GenerateBlock() before using output methods.

Reference