CounterBasedRandomSource<TGenerator, TWord>.SetCounter Method

public void SetCounter(
	ReadOnlySpan<TWord> counter
)

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

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

abstract SetCounter : 
        counter : ReadOnlySpan<'TWord> -> unit 
override SetCounter : 
        counter : ReadOnlySpan<'TWord> -> unit 

Parameters

counter  ReadOnlySpan<TWord>

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