Struct DynamicManagedRefMut 

pub struct DynamicManagedRefMut { /* private fields */ }

Exclusive handle to a value whose type is only known at runtime.

The ManagedRefMut counterpart for script values.

Implementations

impl DynamicManagedRefMut

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

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

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

DynamicManagedRefMut::new for a type only known at runtime. A null pointer yields None.

Safety

data must point at a value of the type named by type_hash, and must stay valid and unaliased for as long as lifetime says it does.

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

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

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

Splits into type, borrow token and pointer.

pub fn into_typed<T>(self) -> Result<ManagedRefMut<T>, Self>

Recovers the typed handle, or gives self back on a type mismatch.

pub fn type_hash(&self) -> &TypeHash

Returns the type of the value.

pub fn lifetime(&self) -> &LifetimeRefMut

Returns the borrow token.

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

Takes a shared handle nested under this one.

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

Takes an exclusive handle nested under this one.

pub fn lazy(&self) -> DynamicManagedLazy

Takes an unclaimed handle.

pub fn is<T>(&self) -> bool

Returns true when the value is a T.

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

Guards the value for reading, or returns None on a type mismatch or while it is written.

pub fn write<T>(&mut self) -> Option<ValueWriteAccess<'_, T>>

Guards the value for writing, or returns None on a type mismatch or while it is accessed.

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

Narrows this handle down to a part of the value, retyping it to U.

Safety

f must return a reference into the same value, and the owner must still be alive. Returns None when the value is not a T.

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

DynamicManagedRefMut::map that can decline.

Safety

Same as DynamicManagedRefMut::map.

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

Returns a typed pointer while the owner is alive.

Safety

The caller takes over checking for conflicting access.

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

Returns a typed mutable pointer while the owner is alive.

Safety

The caller takes over checking for conflicting access.

pub unsafe fn as_ptr_raw(&self) -> Option<*const u8>

Returns the untyped pointer while the owner is alive.

Safety

Neither the type nor conflicting access is checked.

pub unsafe fn as_mut_ptr_raw(&mut self) -> Option<*mut u8>

Returns the untyped mutable pointer while the owner is alive.

Safety

Neither the type nor conflicting access is checked.

Trait Implementations

impl From<DynamicManagedRefMut> for DynamicManagedValue

fn from(value: DynamicManagedRefMut) -> Self

Converts to this type from the input type.

impl Send for DynamicManagedRefMut

impl Sync for DynamicManagedRefMut

impl TryFrom<DynamicManagedValue> for DynamicManagedRefMut

type Error = ()

The type returned in the event of a conversion error.

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

Performs the conversion.