Enum bow::Bow

pub enum Bow<'a, T: 'a + ToBox + ?Sized> {
    Borrowed(&'a T),
    Boxed(Box<T>),
}

Like a Cow, using ToBox instead of ToOwned.

Variants

Borrowed(&'a T)

Borrowed data.

Boxed(Box<T>)

Boxed data.

Methods

impl<'a, T: 'a + ToBox + ?Sized> Bow<'a, T>

fn to_mut(&mut self) -> &mut T

Acquires a mutable reference to the data.

Boxes the data if it is not already boxed.

Examples

use bow::Bow;

let slice = &[3, 2, 1];
let mut bow: Bow<[_]> = Bow::Borrowed(slice);

bow.to_mut().sort();

assert_eq!(bow, &[1, 2, 3]);

fn into_box(self) -> Box<T>

Extracts the data as a box.

Boxes the data if it is not already boxed.

Examples

use bow::Bow;

let slice = &[3, 2, 1];
let mut bow: Bow<[_]> = Bow::Borrowed(slice);

let boxed: Box<[_]> = bow.into_box();

Trait Implementations

impl<'a, T: 'a + ToBox + ?Sized> Clone for Bow<'a, T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T: 'a + ToBox + ?Sized> Into<Box<T>> for Bow<'a, T>

fn into(self) -> Box<T>

Performs the conversion.

impl<'a, T: 'a + ToBox + ?Sized> Deref for Bow<'a, T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<'a, T: 'a + ToBox + Debug + ?Sized> Debug for Bow<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: 'a + ToBox + Display + ?Sized> Display for Bow<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: 'a + ToBox + ?Sized> Default for Bow<'a, T> where
    &'a T: Default, 

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

Returns the "default value" for a type.

impl<'a, T: 'a + ToBox + ?Sized> AsRef<T> for Bow<'a, T>

fn as_ref(&self) -> &T

Performs the conversion.

impl<'a, T: 'a + ToBox + ?Sized> Borrow<T> for Bow<'a, T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<'a, T: 'a + ToBox + ?Sized> From<&'a T> for Bow<'a, T>

fn from(val: &'a T) -> Bow<'a, T>

Performs the conversion.

impl<'a, T: 'a + ToBox + ?Sized> From<Box<T>> for Bow<'a, T>

fn from(val: Box<T>) -> Bow<'a, T>

Performs the conversion.

impl<'a, T: 'a + ToBox + ToOwned + ?Sized> From<Cow<'a, T>> for Bow<'a, T> where
    <T as ToOwned>::Owned: Into<Box<T>>, 

fn from(val: Cow<'a, T>) -> Bow<'a, T>

Performs the conversion.

impl<'a, T: 'a + ToBox + ?Sized + PartialEq, U: AsRef<T>> PartialEq<U> for Bow<'a, T>

fn eq(&self, rhs: &U) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T: 'a + ToBox + ?Sized + Eq> Eq for Bow<'a, T>

impl<'a, T: 'a + ToBox + ?Sized + PartialOrd, U: AsRef<T>> PartialOrd<U> for Bow<'a, T>

fn partial_cmp(&self, rhs: &U) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a, T: 'a + ToBox + ?Sized + Ord> Ord for Bow<'a, T>

fn cmp(&self, rhs: &Bow<'a, T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the minimum of two values.

impl<'a, T: 'a + ToBox + ?Sized + Hash> Hash for Bow<'a, T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].