ChaChaEngine.AdvanceBlock Method

public void AdvanceBlock()

Public Sub AdvanceBlock

public:
virtual void AdvanceBlock() sealed

abstract AdvanceBlock : unit -> unit 
override AdvanceBlock : unit -> unit 

Implements

This method performs the block transition function, moving the engine to a new block of output values. After this call, Output(Int32) will return values from the new block.

The block transition is algorithm-specific and deterministic. Successive calls to AdvanceBlock() move through the generator's sequence in a reproducible manner.

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