Struct BufPool 

pub struct BufPool { /* private fields */ }

A pool of byte buffers in size classes. See the module docs.

Implementations

impl BufPool

pub fn new(classes: [usize; 3], max_cached: usize) -> BufPool

A pool with the given class sizes (ascending) and at most max_cached buffers kept per class (the larger classes keep a quarter and a sixteenth of that).

pub fn classes(&self) -> [usize; 3]

The class sizes.

pub fn get(&mut self, min: usize) -> Vec<u8>

An empty buffer with capacity of at least min bytes: the smallest class that fits, or exactly min when it is larger than every class.

pub fn put(&mut self, buf: Vec<u8>)

Takes a buffer back. It is cleared and kept if its capacity is a class size and that class is not full; otherwise it is freed. Out of line: it is called from many places in the loop, and a call costs nothing next to the free or push it ends in.

pub fn trim(&mut self, keep: usize)

Frees cached buffers until at most keep remain in each class (for trimming after a burst).

pub fn stats(&self) -> PoolStats

Counters.

Trait Implementations

impl Debug for BufPool

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

Formats the value using the given formatter.