Method shuffleExcise

tfjs-data/src/util/ring_buffer.ts:167–175

* Removes and returns a specific item in the buffer, and moves the last item * to the vacated slot. This is useful for implementing a shuffling stream. * Note that this operation necessarily scrambles the original order. * * @param relativeIndex: the index of the item to remove, relativ

(relativeIndex: number)

   *   storage).
   */
  shuffleExcise(relativeIndex: number): T {
    if (this.isEmpty()) {
      throw new RangeError('Ring buffer is empty.');
    }
    const index = this.wrap(this.begin + relativeIndex);
    const result = this.get(index);
    this.set(index, this.pop());
    return result;
  }
}