Struct SampleSink 

pub struct SampleSink<T> { /* private fields */ }

A bounded, non-blocking sink shared between producer and consumer.

Cloning shares the same underlying queue.

Implementations

impl<T> SampleSink<T>

pub fn with_capacity(capacity: usize) -> Self

Create a sink holding at most capacity samples.

A zero capacity is treated as one: a sink that can never accept anything would report 100% drops and hide whether the consumer was ever working.

pub fn offer(&self, sample: T) -> bool

Offer a sample.

Returns true if it was queued, false if it was dropped. Never blocks waiting for the consumer — the whole contract of this type.

pub fn drain(&self) -> Vec<T>

Take everything queued so far.

pub fn len(&self) -> usize

Samples currently queued.

pub fn is_empty(&self) -> bool

Whether nothing is queued.

pub fn stats(&self) -> SinkStats

Accepted and dropped counts.

Trait Implementations

impl<T: Clone> Clone for SampleSink<T>

fn clone(&self) -> SampleSink<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for SampleSink<T>

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

Formats the value using the given formatter.

impl<T> Default for SampleSink<T>

fn default() -> Self

Returns the “default value” for a type.