Struct LifetimeRef 

pub struct LifetimeRef(/* private fields */);

Shared borrow of a Lifetime, the runtime analogue of &T.

Many can coexist and they keep mutable borrows out. Releases its claim on drop.

Implementations

impl LifetimeRef

pub fn state(&self) -> &LifetimeWeakState

Returns the weak state this borrow points at.

pub fn tag(&self) -> usize

Returns the tag the owner had when this borrow was taken.

pub fn exists(&self) -> bool

Returns true while the owning Lifetime is alive and valid.

pub fn can_read(&self) -> bool

Returns true when another shared borrow could be taken.

pub fn is_read_accessible(&self) -> bool

Returns true when no write guard is live.

pub fn is_in_use(&self) -> bool

Returns true while any access guard is live.

pub fn is_owned_by(&self, other: &Lifetime) -> bool

Returns true when this borrow came from other.

pub fn borrow(&self) -> Option<LifetimeRef>

Takes another shared borrow of the same lifetime.

pub async fn borrow_async(&self) -> LifetimeRef

LifetimeRef::borrow, awaiting until it succeeds.

pub fn lazy(&self) -> LifetimeLazy

Takes a lazy handle to the same lifetime.

pub fn read<'a, T: ?Sized>( &'a self, data: &'a T, ) -> Option<ValueReadAccess<'a, T>>

Guards data for reading, or returns None while a write guard is live or the owner is gone.

pub async fn read_async<'a, T: ?Sized>( &'a self, data: &'a T, ) -> ValueReadAccess<'a, T>

LifetimeRef::read, awaiting until it succeeds.

pub unsafe fn read_ptr<T: ?Sized>( &self, data: *const T, ) -> Option<ValueReadAccess<'_, T>>

LifetimeRef::read over a raw pointer.

Safety

data must stay valid and aligned for as long as the returned guard lives. A null pointer yields None.

pub async unsafe fn read_ptr_async<'a, T: ?Sized + 'a>( &'a self, data: *const T, ) -> ValueReadAccess<'a, T>

LifetimeRef::read_ptr, awaiting until it succeeds.

Safety

Same as LifetimeRef::read_ptr, and data must also stay valid across every await point.

pub fn try_read_lock(&self) -> Option<ReadLock>

Claims read access without holding any data.

pub fn read_lock(&self) -> Option<ReadLock>

LifetimeRef::try_read_lock, spinning until it succeeds. Returns None when the owner is gone.

pub async fn read_lock_async(&self) -> ReadLock

LifetimeRef::read_lock, awaiting until it succeeds.

pub fn consume<T: ?Sized>( self, data: &T, ) -> Result<ValueReadAccess<'_, T>, Self>

Turns this borrow into a read guard over data that lives as long as the borrow would have.

Gives the borrow back unchanged when a write guard is live.

pub async fn wait_for_read_access(&self)

Awaits until reading would be allowed, or the owner is gone.

pub async fn wait_for_write_access(&self)

Awaits until writing would be allowed, or the owner is gone.

Trait Implementations

impl Drop for LifetimeRef

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.