Struct Aliasable 

pub struct Aliasable<T> { /* private fields */ }

An unboxed aliasable value.

Implementations

impl<T> Aliasable<T>

pub fn new(val: T) -> Self

Create a new Aliasable that stores val.

pub fn get(self: Pin<&Self>) -> &T

Get a shared reference to the value inside the Aliasable.

This method takes Pin<&Self> instead of &self to enforce that all parent containers are !Unpin, and thus won’t be annotated with noalias.

This crate intentionally does not provide a method to get an &mut T, because the value may be shared. To obtain an &mut T you should use an interior mutable container such as a mutex or UnsafeCell.

pub unsafe fn get_extended<'a>(self: Pin<&Self>) -> &'a T

Get a shared reference to the value inside the Aliasable with an extended lifetime.

Safety

The reference must not be held for longer than the Aliasable exists.

pub fn into_inner(self) -> T

Consume the Aliasable, returning its inner value.

If get has already been called and the type is now pinned, obtaining the owned Aliasable<T> required to call this function requires breaking the pinning guarantee (as the Aliasable<T> is moved). However, this is sound as long as the Aliasable<T> isn’t actually aliased at that point in time.

Trait Implementations

impl<T> Debug for Aliasable<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Aliasable<T>

fn default() -> Aliasable<T>

Returns the “default value” for a type.