Struct DynamicManagedLazy 

pub struct DynamicManagedLazy { /* private fields */ }

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

The ManagedLazy counterpart for script values, and the handle script variables usually hold.

Implementations

impl DynamicManagedLazy

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

Pairs a mutable reference with an unclaimed handle to its lifetime.

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

DynamicManagedLazy::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 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, LifetimeLazy, *mut u8)

Splits into type, lifetime handle and pointer.

pub fn into_typed<T>(self) -> Result<ManagedLazy<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) -> &LifetimeLazy

Returns the lifetime 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>(&self) -> Option<ValueWriteAccess<'_, T>>

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

Takes &self, since a lazy handle claims nothing of its own.

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

Upgrades to a shared handle that holds its claim.

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

Upgrades to an exclusive handle that holds its claim.

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>

DynamicManagedLazy::map that can decline.

Safety

Same as DynamicManagedLazy::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>(&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 Clone for DynamicManagedLazy

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<DynamicManagedLazy> for DynamicManagedValue

fn from(value: DynamicManagedLazy) -> Self

Converts to this type from the input type.

impl Send for DynamicManagedLazy

impl Sync for DynamicManagedLazy

impl TryFrom<DynamicManagedValue> for DynamicManagedLazy

type Error = ()

The type returned in the event of a conversion error.

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

Performs the conversion.