Struct SelfRef 

pub struct SelfRef<T>
where
    T: 'static,
{ /* private fields */ }

A decoded value T that may borrow from its own backing storage.

Transports decode into storage they own (heap buffer, VarSlot, mmap). SelfRef keeps that storage alive so T can safely borrow from it.

Uses ManuallyDrop + custom Drop to guarantee drop order: value is dropped before backing, so borrowed references in T remain valid through T’s drop.

Implementations

impl<T> SelfRef<T>

where T: 'static,

pub fn try_new<E>( backing: Backing, builder: impl FnOnce(&'static [u8]) -> Result<T, E>, ) -> Result<SelfRef<T>, E>

Construct a SelfRef from backing storage and a builder.

The builder receives a &'static [u8] view of the backing bytes — sound because the backing is heap-allocated (stable address) and dropped after the value.

pub fn new( backing: Backing, builder: impl FnOnce(&'static [u8]) -> T, ) -> SelfRef<T>

Infallible variant of try_new.

pub fn owning(backing: Backing, value: T) -> SelfRef<T>

Wrap an owned value that does NOT borrow from backing.

No variance check — the value is fully owned. The backing is kept alive but the value doesn’t reference it. Useful for in-memory transports (MemoryLink) where no deserialization occurs.

pub fn try_repack<U, E>( self, f: impl FnOnce(T, &'static [u8]) -> Result<U, E>, ) -> Result<SelfRef<U>, E>

where U: 'static,

Transform the contained value, keeping the same backing storage.

Useful for projecting through wrapper types: SelfRef<Frame<T>> → SelfRef<T> by extracting the inner item.

The closure receives the old value by move and returns the new value. Any references the new value holds into the backing storage (inherited from fields of T) remain valid — the backing is preserved. Like try_map, but the closure also receives a &'static [u8] view of the backing bytes, so the new value U can borrow from them.

pub fn try_map<U, E>( self, f: impl FnOnce(T) -> Result<U, E>, ) -> Result<SelfRef<U>, E>

where U: 'static,

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

where U: 'static,

impl<T> SelfRef<T>

where T: Reborrow,

pub fn get(&self) -> &<T as Reborrow>::Ref<'_>

Access the inner value with the lifetime properly shortened.

Returns &'a T::Ref<'a> instead of &'a T — the inner lifetime is tied to the borrow, so borrowed data cannot escape the SelfRef.

Trait Implementations

impl<T> Drop for SelfRef<T>

where T: 'static,

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.