Struct GenericContainer

Source
#[repr(transparent)]
pub struct GenericContainer<T: ?Sized, C: ?Sized> { pub _marker: PhantomData<T>, pub container: C, }
Expand description

A wrapper type intended for use in blanket implementations of YourTrait ranging over containers C that hold a T: YourTrait.

This is necessary to avoid conflicting trait implementations.

§Examples

Not needed when the T: YourTrait is fixed:

use generic_container::Container;

trait Trait {
    fn do_thing(&self);
}

impl<C: ?Sized + Container<dyn Trait>> Trait for C {
    fn do_thing(&self) {
        self.get_ref().do_thing();
    }
}

But when the inner type varies:

use generic_container::{Container, GenericContainer};

trait Trait {
    fn do_thing(&self);
}

impl<T: ?Sized + Trait, C: ?Sized + Container<T>> Trait for GenericContainer<T, C> {
    fn do_thing(&self) {
        self.container.get_ref().do_thing();
    }
}

Without a wrapper type, it does not compile:

use generic_container::{Container, GenericContainer};

trait Trait {
    fn do_thing(&self);
}

impl<T: ?Sized + Trait, C: ?Sized + Container<T>> Trait for C {
    fn do_thing(&self) {
        self.get_ref().do_thing();
    }
}

Fields§

§_marker: PhantomData<T>

Distinguish which type is supposed to be contained.

§container: C

Should implement the base container trait, FragileTryContainer<T>.

Implementations§

Source§

impl<T: ?Sized, C> GenericContainer<T, C>

Source

pub const fn new(container: C) -> Self

Create a new GenericContainer struct wrapping the provided value, treated as a container around a specific type.

Trait Implementations§

Source§

impl<T: ?Sized, C: Clone> Clone for GenericContainer<T, C>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T, C> Debug for GenericContainer<T, C>
where T: ?Sized, C: ?Sized + Debug,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: ?Sized, C: Default> Default for GenericContainer<T, C>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<'de, T: ?Sized, C> Deserialize<'de> for GenericContainer<T, C>
where C: Deserialize<'de> + ?Sized,

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl<T: ?Sized, C: ?Sized + Hash> Hash for GenericContainer<T, C>

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<T: ?Sized, C: ?Sized + Ord> Ord for GenericContainer<T, C>

Source§

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

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

Restrict a value to a certain interval. Read more
Source§

impl<T: ?Sized, C: ?Sized + PartialEq<C>> PartialEq for GenericContainer<T, C>

Source§

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl<T: ?Sized, C: ?Sized + PartialOrd<C>> PartialOrd for GenericContainer<T, C>

Source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

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

impl<T: ?Sized, C> Serialize for GenericContainer<T, C>
where C: Serialize + ?Sized,

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl<T: ?Sized, C: Copy> Copy for GenericContainer<T, C>

Source§

impl<T: ?Sized, C: ?Sized + Eq> Eq for GenericContainer<T, C>

Auto Trait Implementations§

§

impl<T, C> Freeze for GenericContainer<T, C>
where C: Freeze + ?Sized, T: ?Sized,

§

impl<T, C> RefUnwindSafe for GenericContainer<T, C>

§

impl<T, C> Send for GenericContainer<T, C>
where C: Send + ?Sized, T: Send + ?Sized,

§

impl<T, C> Sync for GenericContainer<T, C>
where C: Sync + ?Sized, T: Sync + ?Sized,

§

impl<T, C> Unpin for GenericContainer<T, C>
where C: Unpin + ?Sized, T: Unpin + ?Sized,

§

impl<T, C> UnwindSafe for GenericContainer<T, C>
where C: UnwindSafe + ?Sized, T: UnwindSafe + ?Sized,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> FragileContainer<T> for T
where T: ?Sized,

Source§

fn get_ref(&self) -> <T as FragileTryContainer<T>>::Ref<'_>

Infallibly get immutable access to the T.

Source§

impl<T> FragileMutContainer<T> for T
where T: ?Sized,

Source§

fn get_mut(&mut self) -> <T as FragileTryMutContainer<T>>::RefMut<'_>

Infallibly get mutable access to the T.

Source§

impl<T> FragileTryContainer<T> for T
where T: ?Sized,

Source§

fn into_inner(self) -> Option<T>

Infallibly get the T.

Source§

fn try_get_ref( &self, ) -> Result<<T as FragileTryContainer<T>>::Ref<'_>, <T as FragileTryContainer<T>>::RefError>

Infallibly get immutable access to the T.

Source§

type Ref<'a> = &'a T where T: 'a

An immutably borrowed value from the container. Read more
Source§

type RefError = Infallible

An error that might be returned by try_get_ref. This type should implement std::error::Error. Read more
Source§

fn new_container(t: T) -> T

Create a new container that owns the provided T.
Source§

impl<T> FragileTryMutContainer<T> for T
where T: ?Sized,

Source§

fn try_get_mut( &mut self, ) -> Result<<T as FragileTryMutContainer<T>>::RefMut<'_>, <T as FragileTryMutContainer<T>>::RefMutError>

Infallibly get mutable access to the T.

Source§

type RefMut<'a> = &'a mut T where T: 'a

A mutably borrowed value from the container. Read more
Source§

type RefMutError = Infallible

An error that might be returned by try_get_mut. This type should implement std::error::Error. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T, C> BaseContainer<T> for C
where C: FragileTryContainer<T> + ?Sized, T: ?Sized,

Source§

impl<T, C> BaseMutContainer<T> for C
where C: FragileTryMutContainer<T> + ?Sized, T: ?Sized,

Source§

impl<T> Container<T> for T
where T: ?Sized,

Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> MutContainer<T> for T
where T: ?Sized,

Source§

impl<T> TryContainer<T> for T
where T: ?Sized,

Source§

impl<T> TryMutContainer<T> for T
where T: ?Sized,