Struct ManagedRefMut 

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

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

Can be reborrowed, both shared and exclusive, one level deeper.

Implementations

impl<T: ?Sized> ManagedRefMut<T>

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

Pairs a mutable reference with an exclusive borrow of its lifetime.

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

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

Safety

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

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

Builds a handle to a plain mutable 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: *mut T) -> Option<(Self, Lifetime)>

ManagedRefMut::make over a raw pointer.

Safety

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

pub fn into_inner(self) -> (LifetimeRefMut, *mut T)

Splits into the borrow token and the pointer.

pub fn into_dynamic(self) -> DynamicManagedRefMut

Erases the type, keeping the same claim.

pub fn lifetime(&self) -> &LifetimeRefMut

Returns the borrow token.

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

Takes a shared handle nested under this one.

pub fn borrow_mut(&mut self) -> Option<ManagedRefMut<T>>

Takes an exclusive handle nested under this one.

pub fn lazy(&self) -> ManagedLazy<T>

Takes an unclaimed handle.

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 fn write(&mut self) -> Option<ValueWriteAccess<'_, T>>

Guards the value for writing, or returns None when it is accessed or the owner is gone.

pub unsafe fn map<U>(self, f: impl FnOnce(&mut T) -> &mut U) -> ManagedRefMut<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(&mut T) -> Option<&mut U>, ) -> Option<ManagedRefMut<U>>

ManagedRefMut::map that can decline.

Safety

Same as ManagedRefMut::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.

pub unsafe fn as_mut_ptr(&mut self) -> Option<*mut T>

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

Safety

The caller takes over checking for conflicting access.

Trait Implementations

impl<T> From<ManagedRefMut<T>> for ManagedValue<T>

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

Converts to this type from the input type.

impl<T> Send for ManagedRefMut<T>

where T: Send + ?Sized,

impl<T> Sync for ManagedRefMut<T>

where T: Sync + ?Sized,

impl<T> TryFrom<ManagedValue<T>> for ManagedRefMut<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.