Struct Slot

pub struct Slot<'a, T: ?Sized = Void>(/* private fields */);

A memory block used to store arbitrary objects.

Implementations

impl<'a> Slot<'a>

pub unsafe fn new_unchecked(ptr: NonNull<u8>) -> Self

Creates a new slot from the supplied pointer.

Safety

• The returned instance may not be used outside of construct.
• Constructs will write objects directly to the address of ptr, hence ptr must meet all safety requirements of construct.

pub unsafe fn write_unchecked<T>(self, object: T) -> NonNull<T>

Consumes this slot, filling it with the supplied object.

Safety

The object may not have a different layout than the one returned from PinConstruct::layout.

pub unsafe fn cast<T>(self) -> Slot<'a, T>

Transforms this slot into a typed one.

Safety

The layout of T must match that from PinConstruct::layout exactly.

impl<'a, T> Slot<'a, T>

pub fn write(self, object: T) -> &'a mut Opaque<T>

Consumes this slot, filling it with the supplied object.

The returned object is sealed in Opaque to prevent misuse. Despite this, as demonstrated below, it’s still possible to coerce it into a trait object:

fn fill_slot(slot: Slot<String>) -> &mut Opaque<dyn Any> {
    slot.write(String::from("WRYYY!")) as &mut Opaque<dyn Any>
}

impl<'a, T: ?Sized> Slot<'a, T>

pub fn into_raw(self) -> NonNull<u8>

Consumes this instance, returning a raw pointer to the allocated memory block.

Trait Implementations

impl<T: ?Sized> Debug for Slot<'_, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.