RingBuffer[A: A]¶

A ring buffer.

class ref RingBuffer[A: A]

Constructors¶

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^

The first read that will succeed. If nothing has been written to the ring, this will raise an error.

fun box head()
: USize val ?

The number of elements that have been added to the ring.

fun box size()
: USize val

The available space in the ring.

fun box space()
: 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 ?

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

Clear the queue.

fun ref clear()
: None val