ChaChaEngine.SetCounter Method

public void SetCounter(
	ReadOnlySpan<uint> counter
)

Public Sub SetCounter ( 
	counter As ReadOnlySpan(Of UInteger)
)

public:
virtual void SetCounter(
	ReadOnlySpan<unsigned int> counter
) sealed

abstract SetCounter : 
        counter : ReadOnlySpan<uint32> -> unit 
override SetCounter : 
        counter : ReadOnlySpan<uint32> -> unit 

Parameters

counter  ReadOnlySpan<UInt32>

The new counter value. Length must exactly match CounterLength.

Implements

Setting the counter moves the generator to a specific position in the output sequence. This enables O(1) skip-ahead to arbitrary positions.

Consistency Protocol:

After calling SetCounter(ReadOnlySpan<T>), the engine enters an inconsistent state where the cached block does not correspond to the current key/counter coordinates. Callers must invoke GenerateBlock() before using any output mapping methods (Output(Int32) or Fill(Int32, Span<T>)). Invoking output methods while inconsistent results in undefined behavior.

Reference