Packages

c

net.psforever.objects.guid.selector

RandomSequenceSelector

class RandomSequenceSelector extends NumberSelector

Get a pseudorandom number from a pool of numbers. The output of this class, operating on an Array of Int 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 system Random 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 input Array 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 the Array and wraps back around to that start.

Source
RandomSequenceSelector.scala
See also

RandomSelector

Linear Supertypes
NumberSelector, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. RandomSequenceSelector
  2. NumberSelector
  3. AnyRef
  4. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new RandomSequenceSelector()

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def Format(ary: Array[Int]): Unit

    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.

    ary

    the Array of Int numbers

    Definition Classes
    NumberSelector
  5. def Get(ary: Array[Int]): Int

    Accept a provided "pool of numbers" and select the next number.

    Accept a provided "pool of numbers" and select the next number.

    ary

    the Array of Int numbers from which to draw a new number

    returns

    an Int number

    Definition Classes
    RandomSequenceSelector → NumberSelector
  6. def Return(number: Int, ary: Array[Int]): Boolean

    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.

    number

    the number to be returned

    ary

    the Array of Int numbers to which the number is to be returned

    returns

    true, if this return was successful; false, otherwise

    Definition Classes
    RandomSequenceSelector → NumberSelector
  7. def ReturnIndex: Int
    Definition Classes
    NumberSelector
  8. def SelectionIndex: Int
    Definition Classes
    NumberSelector
  9. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  10. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  11. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  13. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  14. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  15. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  16. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  17. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  18. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  19. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  20. var ret: Int

    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.

    Attributes
    protected
    Definition Classes
    NumberSelector
  21. var selectionIndex: Int

    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.

    Attributes
    protected
    Definition Classes
    NumberSelector
  22. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  23. def toString(): String
    Definition Classes
    AnyRef → Any
  24. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  25. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  26. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from NumberSelector

Inherited from AnyRef

Inherited from Any

Ungrouped