Struct DiscardOnDrop

pub struct DiscardOnDrop<A: Discard>(/* private fields */);

If you have a value which implements Discard, you can use DiscardOnDrop::new(value) which will wrap the value. When the wrapper is dropped it will automatically call value.discard().

You can use the DiscardOnDrop::leak function to unwrap it (which returns value). This causes it to no longer call discard when it is dropped, which means it will leak memory unless you manually call discard.

See the module documentation for more details.

Implementations

impl<A: Discard> DiscardOnDrop<A>

pub fn new(discarder: A) -> Self

Creates a new DiscardOnDrop.

When the DiscardOnDrop is dropped it will automatically call discarder.discard().

See the module documentation for more details.

pub fn leak(this: Self) -> A

Returns the wrapped discarder.

It will no longer automatically call discarder.discard(), so this will leak memory unless you manually call discarder.discard().

See the module documentation for more details.

This is implemented as a function (not a method) so that way it doesn’t interfere with any of the methods on discarder.

Trait Implementations

impl<A: Debug + Discard> Debug for DiscardOnDrop<A>

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

Formats the value using the given formatter.

impl<A: Discard> Deref for DiscardOnDrop<A>

type Target = A

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<A: Discard> DerefMut for DiscardOnDrop<A>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<A: Discard> Drop for DiscardOnDrop<A>

fn drop(&mut self)

Executes the destructor for this type.