Struct Cow

pub struct Cow<'a, T> { /* private fields */ }

A pointer-sized object that holds either a borrow (&'a T) or a boxed value (Box<T>).

TODO doc: implements deref, construction, ToOwned, etc.

Notes

Because it uses PointerValuePair internally, T cannot not be a zero-sized type.

Implementations

impl<'a, T> Cow<'a, T>

pub fn borrowed(v: &'a T) -> Cow<'a, T>

Creates a new Cow representing a borrowed value.

pub fn owned(v: Box<T>) -> Cow<'a, T>

Creates a new Cow holding a boxed value.

impl<'a, T> Cow<'a, T>

where T: Clone,

pub fn into_owned(self) -> Box<T>

Converts this Cow into a Box<T>. If this Cow is a borrow, clones the value and boxes it.

pub fn into_owned_cow<'b>(self) -> Cow<'b, T>

Converts this Cow into an owned Cow by cloning the value and boxing it, if it is borrowed.

Trait Implementations

impl<'a, T> Deref for Cow<'a, T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<'a, T> Drop for Cow<'a, T>

fn drop(&mut self)

Executes the destructor for this type.