Accept the indexing pool from which numbers are selected and returned.
Accept the indexing pool from which numbers are selected and returned.
Correct its format to suit the current NumberSelector
algorithms.
Moving all of the invalid negative-ones (-1) to the left of the current valid indices works for most selectors.
The selectionIndex
is set to the first valid number available from the left.
The ret
index is set to index zero.
the Array
of Int
numbers
Accept a provided "pool of numbers" and select the next number.
Accept a provided "pool of numbers" and select the next number.
the Array
of Int
numbers from which to draw a new number
an Int
number
Give a number back to a specific collection following the principles of this selector.
Give a number back to a specific collection following the principles of this selector.
the number to be returned
the Array
of Int
numbers to which the number is to be returned
true
, if this return was successful; false
, otherwise
The index for the selector when performing a number return action, then modified for the "next" index.
The index for the selector when performing a number return action, then modified for the "next" index.
The index for the selector when performing a number selection action, then modified to the "next" index.
The index for the selector when performing a number selection action, then modified to the "next" index.
Get a pseudorandom number from a pool of numbers. The output of this class, operating on an
Array
ofInt
values is contained to some sequence of all the numbers. Only after every number is selected once, may any number repeat. The pseudorandomness of any sequence of numbers is not only provided by an internal systemRandom
but by the order or returned numbers. Consequentially, as any single sequence nears completion, the numbers remaining become more and more predictable.During the selection process:
The index is the position from where the selection begins, and the end of the
Array
is where the selection ends. Once a position between those two indices is selected, that number is extracted. The number at the start position is swapped into the position where the selection number was extracted. The start position is then set to an invalid number, and the start index is advanced. Repeat next request.The return index trails behind the selection index as far as the order of the array is concerned at first. After some time, the selection index moves to the starting position of the array again and then the order is reversed. Until the return index wraps around to the beginning of the array too, it is considered the valid selection end position.
During the return process:
As the
Array
empties out from the first to the last index, the return process starts at the first index again. When a number is "returned," it is placed back into the inputArray
at the earliest available index. The return index is advanced. Neither the selection index nor the return index may pass each other, except when one reaches the end of theArray
and wraps back around to that start.RandomSelector