Struct rtrb_basedrop::RingBuffer

pub struct RingBuffer<T: Send + 'static> { /* private fields */ }

A bounded single-producer single-consumer (SPSC) queue.

Elements can be written with a Producer and read with a Consumer, both of which can be obtained with RingBuffer::new().

See also the crate-level documentation.

Implementations

impl<T: Send + 'static> RingBuffer<T>

pub fn new(capacity: usize, handle: &Handle) -> (Producer<T>, Consumer<T>)

Creates a RingBuffer with the given capacity and returns Producer and Consumer.

Examples

use rtrb_basedrop::RingBuffer;
use basedrop::Collector;

let collector = Collector::new();

let (producer, consumer) = RingBuffer::<f32>::new(100, &collector.handle());

Specifying an explicit type with the turbofish is is only necessary if it cannot be deduced by the compiler.

use rtrb_basedrop::RingBuffer;
use basedrop::Collector;

let collector = Collector::new();

let (mut producer, consumer) = RingBuffer::new(100, &collector.handle());
assert_eq!(producer.push(0.0f32), Ok(()));

pub fn capacity(&self) -> usize

Returns the capacity of the queue.

Examples

use rtrb_basedrop::RingBuffer;
use basedrop::Collector;

let collector = Collector::new();

let (producer, consumer) = RingBuffer::<f32>::new(100, &collector.handle());
assert_eq!(producer.buffer().capacity(), 100);
assert_eq!(consumer.buffer().capacity(), 100);
// Both producer and consumer of course refer to the same ring buffer:
assert_eq!(producer.buffer(), consumer.buffer());

Trait Implementations

impl<T: Send + 'static> Debug for RingBuffer<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Send + 'static> Drop for RingBuffer<T>

fn drop(&mut self)

Drops all non-empty slots.

impl<T: Send + 'static> PartialEq<RingBuffer<T>> for RingBuffer<T>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

Examples

use rtrb_basedrop::RingBuffer;
use basedrop::Collector;

let collector = Collector::new();

let (p1, c1) = RingBuffer::<f32>::new(1000, &collector.handle());
assert_eq!(p1.buffer(), c1.buffer());

let (p2, c2) = RingBuffer::<f32>::new(1000, &collector.handle());
assert_ne!(p1.buffer(), p2.buffer());

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: Send + 'static> Eq for RingBuffer<T>

impl<T: Send + 'static> Send for RingBuffer<T>