Struct AliasedBox 

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

Available on crate feature embedded_runtime only.

An owned heap allocation, like Box, but without Box’s unique-aliasing guarantee.

Moving a Box asserts that it is the only pointer to its contents (noalias), invalidating raw pointers previously derived from them (e.g. under Stacked Borrows). AliasedBox stores only a raw pointer, so it may be freely moved — such as into the holder struct built by embedded_flow! — while InputStreams and sink closures hold NonNull pointers into its contents.

The contents are never moved and never exposed as &mut (only Deref), so their address is stable from construction until drop; this is what makes as_pin sound.

Implementations

impl<T> AliasedBox<T>

pub fn new(value: T) -> Self

Heap-allocates value.

pub fn as_pin(&self) -> Pin<&T>

Returns the contents as a pinned reference.

This is safe because the contents are heap-allocated, never moved, and never exposed mutably, so they remain at the same address until self is dropped (at which point their destructor runs, upholding the Pin drop guarantee).

Trait Implementations

impl<T: Debug> Debug for AliasedBox<T>

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

Formats the value using the given formatter.

impl<T> Deref for AliasedBox<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T> Drop for AliasedBox<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.