Struct thingbuf::recycling::DefaultRecycle

pub struct DefaultRecycle(/* private fields */);

A Recycle implementation for any type implementing Default and Clone.

This creates new elements by calling using Default::default(). Existing elements are recycled by calling Clone::clone_from with the default value.

Allocation Reuse

Clone::clone_from is not guaranteed to reuse existing allocations in place. For a number of common types in the standard library, such as Box, String, Vec, and collections based on Vec (such as VecDeque and BinaryHeap), clone_from is overridden to reuse existing allocations in place. However, other types may not override clone_from in this way.

DefaultRecycle will always work for types that implement Default and Clone, but it cannot be guaranteed to always reuse allocations. For a more restrictive Recycle implementation that will always reuse existing allocations, consider WithCapacity.

Implementations

impl DefaultRecycle

pub const fn new() -> Self

Returns a new DefaultRecycle.

Trait Implementations

impl Clone for DefaultRecycle

fn clone(&self) -> DefaultRecycle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DefaultRecycle

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

Formats the value using the given formatter.

impl Default for DefaultRecycle

fn default() -> DefaultRecycle

Returns the “default value” for a type.

impl<T> Recycle<T> for DefaultRecycle

where T: Default + Clone,

fn new_element(&self) -> T

Returns a new instance of type T.

fn recycle(&self, element: &mut T)

Prepares element element for reuse.