Struct Managed 

pub struct Managed<T> { /* private fields */ }

Owner of a value plus its runtime borrow state.

The value is stored inline, so this is just T with a lifetime attached. Handles taken from it go dead when it is dropped. See the module docs.

Implementations

impl<T> Managed<T>

pub fn new(data: T) -> Self

Takes ownership of a value with a fresh lifetime.

pub fn new_raw(data: T, lifetime: Lifetime) -> Self

Takes ownership of a value with a lifetime prepared elsewhere.

pub fn into_inner(self) -> (Lifetime, T)

Splits into the lifetime and the value, dropping no handles.

pub fn into_dynamic(self) -> Result<DynamicManaged, Self>

Moves the value into a type-erased box, giving self back when the allocation fails.

The lifetime is not carried over, so handles taken so far go dead.

pub fn renew(self) -> Self

Replaces the lifetime, killing every handle taken so far.

pub fn lifetime(&self) -> &Lifetime

Returns the borrow state of this value.

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

Guards the value for reading, or returns None while it is written.

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

Guards the value for writing, or returns None while it is accessed.

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

Takes the value out, or gives the box back while any access guard is live.

pub fn move_into_ref(self, target: ManagedRefMut<T>) -> Result<(), Self>

Moves the value into the place target points at.

Panics

Panics when target cannot be written.

pub fn move_into_lazy(self, target: ManagedLazy<T>) -> Result<(), Self>

Moves the value into the place target points at.

Panics

Panics when target cannot be written.

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

Takes a shared handle, or returns None when an exclusive one is out.

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

Takes an exclusive handle, or returns None when any handle is out.

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

Takes an unclaimed handle.

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

Managed::lazy from a shared reference.

Safety

The returned handle can write to a value the caller only borrowed immutably. Only use it when nothing else holds a &T to it.

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

Replaces the value with one built from it, under a fresh lifetime.

Safety

Handles taken so far are not checked before the value is moved out, and they go dead. Nothing may be accessing the value.

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

Managed::map that can decline, dropping the value when it does.

Safety

Same as Managed::map.

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

Returns a pointer to the value, bypassing the borrow state.

Safety

The caller takes over checking for conflicting access, and must not outlive this box.

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

Returns a mutable pointer to the value, bypassing the borrow state.

Safety

The caller takes over checking for conflicting access, and must not outlive this box.

Trait Implementations

impl<T: Default> Default for Managed<T>

fn default() -> Managed<T>

Returns the “default value” for a type.

impl<T> From<Managed<T>> for ManagedValue<T>

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

Converts to this type from the input type.

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