Class

net.psforever.objects.guid.selector

RandomSelector

Related Doc: package selector

Permalink

class RandomSelector extends NumberSelector

Get a pseudorandom number from a pool of numbers. The contained logic is similar to RandomSequenceSelector. It is not reliant of a shrinking pool that composes into some sequence of all the numbers, however; the numbers are re-introduced to the selection as long as the pool is used. This allows for the sequence to contain repeat numbers far before ever visiting all of the numbers once.

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.

During the return process:
The returned number is added to the input Array at the position just before the current selection position. The selection index is then reversedback to re-include the returned number. The normal return index is not used in this algorithm.

Source
RandomSelector.scala
See also

RandomSequenceSelector

Linear Supertypes
NumberSelector, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. RandomSelector
  2. NumberSelector
  3. AnyRef
  4. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new RandomSelector()

    Permalink

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to any2stringadd[RandomSelector] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (RandomSelector, B)

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to ArrowAssoc[RandomSelector] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  6. def Format(ary: Array[Int]): Unit

    Permalink

    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
  7. def Get(ary: Array[Int]): Int

    Permalink

    Accept a provided pool and select the next number.

    ...

    Accept a provided pool and select the next number.

    ...

    ary

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

    returns

    an Int number

    Definition Classes
    RandomSelectorNumberSelector
  8. def Return(number: Int, ary: Array[Int]): Boolean

    Permalink

    Give a number back to a specific collection following the principles of this selector.

    The number is always returned to a "used" index position near the front of the array.

    Give a number back to a specific collection following the principles of this selector.

    The number is always returned to a "used" index position near the front of the array. It locates this position by incrementally traversing the Array behind the position used in Get. Asides from selection, a disorderly reinsertion of numbers back into the pool is also a source of randomness.

    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
    RandomSelectorNumberSelector
  9. def ReturnIndex: Int

    Permalink
    Definition Classes
    NumberSelector
  10. def SelectionIndex: Int

    Permalink
    Definition Classes
    NumberSelector
  11. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  12. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  13. def ensuring(cond: (RandomSelector) ⇒ Boolean, msg: ⇒ Any): RandomSelector

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to Ensuring[RandomSelector] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def ensuring(cond: (RandomSelector) ⇒ Boolean): RandomSelector

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to Ensuring[RandomSelector] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: Boolean, msg: ⇒ Any): RandomSelector

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to Ensuring[RandomSelector] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. def ensuring(cond: Boolean): RandomSelector

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to Ensuring[RandomSelector] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  17. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  18. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  19. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  20. def formatted(fmtstr: String): String

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to StringFormat[RandomSelector] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  21. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  22. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  23. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  24. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  25. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  26. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  27. var ret: Int

    Permalink

    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
  28. var selectionIndex: Int

    Permalink

    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
  29. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  30. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  31. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  32. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  33. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  34. def [B](y: B): (RandomSelector, B)

    Permalink
    Implicit information
    This member is added by an implicit conversion from RandomSelector to ArrowAssoc[RandomSelector] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Inherited from NumberSelector

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from RandomSelector to any2stringadd[RandomSelector]

Inherited by implicit conversion StringFormat from RandomSelector to StringFormat[RandomSelector]

Inherited by implicit conversion Ensuring from RandomSelector to Ensuring[RandomSelector]

Inherited by implicit conversion ArrowAssoc from RandomSelector to ArrowAssoc[RandomSelector]

Ungrouped