Struct ManagedRef 

pub struct ManagedRef<T: ?Sized> { /* private fields */ }

Shared handle to a value owned by a Managed, the runtime &T.

Keeps its claim until dropped, and reports a dead owner by returning None from ManagedRef::read.

Implementations

impl<T: ?Sized> ManagedRef<T>

pub fn new(data: &T, lifetime: LifetimeRef) -> Self

Pairs a reference with a shared borrow taken from its lifetime.

pub unsafe fn new_raw(data: *const T, lifetime: LifetimeRef) -> Option<Self>

ManagedRef::new over a raw pointer. A null pointer yields None.

Safety

data must stay valid for as long as lifetime says it does, and lifetime must be the borrow state that guards it.

pub fn make(data: &T) -> (Self, Lifetime)

Builds a handle to a plain reference along with the lifetime that backs it.

The caller has to keep the returned Lifetime alive for at least as long as the handle.

pub unsafe fn make_raw(data: *const T) -> Option<(Self, Lifetime)>

ManagedRef::make over a raw pointer.

Safety

data must stay valid for as long as the returned handle lives.

pub fn into_inner(self) -> (LifetimeRef, *const T)

Splits into the borrow token and the pointer.

pub fn into_dynamic(self) -> DynamicManagedRef

Erases the type, keeping the same claim.

pub fn lifetime(&self) -> &LifetimeRef

Returns the borrow token.

pub fn borrow(&self) -> Option<ManagedRef<T>>

Takes another shared handle to the same value.

pub unsafe fn lazy_immutable(&self) -> ManagedLazy<T>

Turns this shared handle into an unclaimed one that can also write.

Safety

The value was only borrowed immutably, so writing through the result is only sound when nothing else holds a &T to it.

pub fn read(&self) -> Option<ValueReadAccess<'_, T>>

Guards the value for reading, or returns None when it is written or the owner is gone.

pub unsafe fn map<U>(self, f: impl FnOnce(&T) -> &U) -> ManagedRef<U>

Narrows this handle down to a part of the value, such as one field.

Safety

f must return a reference into the same value, and the owner must still be alive.

pub unsafe fn try_map<U>( self, f: impl FnOnce(&T) -> Option<&U>, ) -> Option<ManagedRef<U>>

ManagedRef::map that can decline.

Safety

Same as ManagedRef::map.

pub unsafe fn as_ptr(&self) -> Option<*const T>

Returns the pointer while the owner is alive, bypassing access checks.

Safety

The caller takes over checking for conflicting access.

Trait Implementations

impl<T> From<ManagedRef<T>> for ManagedValue<T>

fn from(value: ManagedRef<T>) -> Self

Converts to this type from the input type.

impl<T> Send for ManagedRef<T>

where T: Send + ?Sized,

impl<T> Sync for ManagedRef<T>

where T: Sync + ?Sized,

impl<T> TryFrom<ManagedValue<T>> for ManagedRef<T>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: ManagedValue<T>) -> Result<Self, Self::Error>

Performs the conversion.