Struct Reservoir 

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

Reservoir sampler using Algorithm R.

Maintains a fixed-size sample of items seen so far, with each item having equal probability of being in the sample.

Implementations

impl<T> Reservoir<T>

pub fn new(capacity: usize, rng: StdRng) -> Self

Create a new reservoir with the given capacity

pub fn consider(&mut self, item: T)

Consider an item for inclusion in the reservoir

pub fn total_seen(&self) -> usize

Get the number of items seen so far

pub fn len(&self) -> usize

Get the current size of the reservoir

pub fn is_empty(&self) -> bool

Check if the reservoir is empty

pub fn capacity(&self) -> usize

Get the capacity of the reservoir

pub fn into_items(self) -> Vec<T>

Consume the reservoir and return the sampled items

pub fn items(&self) -> &[T]

Get a reference to the current items

Trait Implementations

impl<T: Debug> Debug for Reservoir<T>

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

Formats the value using the given formatter.