Struct Owned

#[repr(transparent)]
pub struct Owned<B>(pub <B as ToOwned>::Owned)
where
    B: ?Sized + ToOwned;

Wrapper akin to Cow::Owned but known to be owned at compile-time

The wrapper takes a type argument B and a value of type <B as ToOwned>::Owned. It supports dereference (with B being the target), implements Borrow<B>, and GenericCow<Borrowed = B>.

Example

use deref_owned::{GenericCow, Owned};
use std::borrow::Cow;

fn generic_fn(arg: impl GenericCow<Borrowed = str>) { /* ... */ }

generic_fn(Owned("Hello".to_string()));
generic_fn(Cow::Owned("Hello".to_string()));
generic_fn(Cow::Borrowed("Hello"));
generic_fn("Hello");

Tuple Fields

0: <B as ToOwned>::Owned

Trait Implementations

impl<B, U> AsRef<U> for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: AsRef<U>, U: ?Sized,

AsRef is only implemented when the inner type implements AsRef. This is consistent with the blanket implementation of AsRef for shared references but not consistent with Cow’s implementation of AsRef.

fn as_ref(&self) -> &U

Converts this type into a shared reference of the (usually inferred) input type.

impl<B> Borrow<B> for Owned<B>

where B: ?Sized + ToOwned,

fn borrow(&self) -> &B

Immutably borrows from an owned value.

impl<B> Clone for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: Clone,

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<B> Debug for Owned<B>

where B: ?Sized + ToOwned + Debug, <B as ToOwned>::Owned: Debug,

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

Formats the value using the given formatter.

impl<B> Default for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: Default,

fn default() -> Self

Returns the “default value” for a type.

impl<B> Deref for Owned<B>

where B: ?Sized + ToOwned,

type Target = B

The resulting type after dereferencing.

fn deref(&self) -> &B

Dereferences the value.

impl<B> Display for Owned<B>

where B: ?Sized + ToOwned + Display, <B as ToOwned>::Owned: Display,

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

Formats the value using the given formatter.

impl<B> GenericCow for Owned<B>

where B: ?Sized + ToOwned,

type Borrowed = B

Borrowed type

fn into_owned(self) -> <B as ToOwned>::Owned

Convert into owned type

impl<B> Hash for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: Hash,

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

where H: Hasher,

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<B> Ord for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: Ord,

fn cmp(&self, other: &Owned<B>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<B, C> PartialEq<Owned<C>> for Owned<B>

where B: ?Sized + ToOwned, C: ?Sized + ToOwned, <B as ToOwned>::Owned: PartialEq<<C as ToOwned>::Owned>,

fn eq(&self, other: &Owned<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Owned<C>) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<B, C> PartialOrd<Owned<C>> for Owned<B>

where B: ?Sized + ToOwned, C: ?Sized + ToOwned, <B as ToOwned>::Owned: PartialOrd<<C as ToOwned>::Owned>,

fn partial_cmp(&self, other: &Owned<C>) -> Option<Ordering>

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

fn lt(&self, other: &Owned<C>) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Owned<C>) -> bool

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

fn gt(&self, other: &Owned<C>) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Owned<C>) -> bool

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

impl<B> Eq for Owned<B>

where B: ?Sized + ToOwned, <B as ToOwned>::Owned: Eq,