collections RingBuffer - tadashi9e/gmp4pony GitHub Wiki
A ring buffer.
class ref RingBuffer[A: A]Create a ring buffer with a fixed size. The size will be rounded up to the next power of 2.
new ref create(
len: USize val)
: RingBuffer[A] ref^- len: USize val
- RingBuffer[A] ref^
The first read that will succeed. If nothing has been written to the ring, this will raise an error.
fun box head()
: USize val ?- USize val ?
The number of elements that have been added to the ring.
fun box size()
: USize val- USize val
The available space in the ring.
fun box space()
: USize val- USize val
Get the i-th element from the ring. If the i-th element has not yet been added or is no longer available, this will raise an error.
fun box apply(
i: USize val)
: this->A ?- i: USize val
- this->A ?
Add an element to the ring. If the ring is full, this will drop the oldest element in the ring. Returns true if an element was dropped.
fun ref push(
value: A)
: Bool val- value: A
- Bool val
Clear the queue.
fun ref clear()
: None val- None val