Enum zerodrop::ZeroDropCow

pub enum ZeroDropCow<'a, T: Copy + 'a> {
    Borrowed(&'a T),
    Boxed(Box<T>),
}

Zeroing drop copy-on-write type for Copy types.

Assuming T: Copy, a ZeroDrop<T> wraps a Box<T> and zeros it when dropped. Unlike Cow, we must use Box because LLVM moves data wildly around the stack.

Variants

Borrowed(&'a T)

Borrowed data.

Boxed(Box<T>)

Boxed data.

Methods

impl<'a, T> ZeroDropCow<'a, T> where T: 'a + Copy

fn new_insecure(t: T) -> ZeroDropCow<'a, T>

Insecure as t likely gets placed on the stack

unsafe fn new_uninitialized() -> ZeroDropCow<'a, T>

Secure but unsafe

fn new(t: &'a T) -> ZeroDropCow<'a, T>

Create a ZeroDrop<T> for a T: Copy that borrows its argument.

fn new_copy(t: &T) -> ZeroDropCow<'a, T>

Create a ZeroDrop<T> for a T: Copy consisting of a Box<T> that will be zeroed when dropped. Use ZeroDrop instead normally.

fn into_boxed(self) -> ZeroDrop<T>

Convert a ZeroDrowCow into a ZeroDrop, copying if still borrowed.

Trait Implementations

impl<'a, T> Drop for ZeroDropCow<'a, T> where T: 'a + Copy

Zero a ZeroDrop<T> when dropped.

fn drop(&mut self)

A method called when the value goes out of scope.

impl<'a, T> Default for ZeroDropCow<'a, T> where T: 'a + Copy + Default

fn default() -> ZeroDropCow<'a, T>

Creates a boxed ZeroDropCow<'a, T> with the default value for the contained owned value.

impl<'a, T> Clone for ZeroDropCow<'a, T> where T: 'a + Copy

Reborrow a Borrowed or Clone a Boxed

fn clone(&self) -> ZeroDropCow<'a, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T> Deref for ZeroDropCow<'a, T> where T: 'a + Copy

Delegate Deref to Borrowed or Boxed.

type Target = T

The resulting type after dereferencing

fn deref(&self) -> &T

The method called to dereference a value

impl<'a, T, U> AsRef<U> for ZeroDropCow<'a, T> where T: 'a + Copy + AsRef<U>

Delegate AsRef<_> to Borrowed or Boxed.

fn as_ref(&self) -> &U

Performs the conversion.

impl<'a, T> Borrow<T> for ZeroDropCow<'a, T> where T: 'a + Copy

Delegate Borrow<T> to Borrowed or Boxed.

fn borrow(&self) -> &T

Immutably borrows from an owned value.