Struct StackPtr

pub struct StackPtr<'a, T: 'a + ?Sized> { /* private fields */ }

An owning pointer to stack-allocated data. Similar to Box, except Box is heap-allocated.

Implementations

impl<'a, T: 'a + ?Sized> StackPtr<'a, T>

pub unsafe fn new(ptr: *mut T, _lifetime: &'a mut ()) -> StackPtr<'a, T>

ptr must be a pointer to forgotten data on the stack, whose lifetime is at least as long as lifetime’s lifetime. Better to just use the stack_ptr! macro.

pub fn borrow(&self) -> &'a T

an implementation of std::borrow::Borrow, where the returned reference has the same lifetime as self.

pub fn borrow_mut(&mut self) -> &'a mut T

an implementation of std::borrow::BorrowMut, where the returned reference has the same lifetime as self.

pub fn into_raw_parts(sp: StackPtr<'a, T>) -> (*mut T, PhantomData<&'a mut ()>)

Consumes a StackPtr without running its destructor, and returns a *mut pointer to the data, and a std::marker::PhantomData representing the lifetime of the StackPtr. Useful for doing a conversion on the pointer and reconstructing a StackPtr with from_raw_parts.

pub unsafe fn from_raw_parts( ptr: *mut T, lifetime: PhantomData<&'a mut ()>, ) -> StackPtr<'a, T>

Constructs a new StackPtr from its raw parts. Usually called on the result of into_raw_parts.

Trait Implementations

impl<'a, T> Debug for StackPtr<'a, T>

where T: Debug + ?Sized,

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

Formats the value using the given formatter.

impl<'a, T: ?Sized> Deref for StackPtr<'a, T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<'a, T: ?Sized> DerefMut for StackPtr<'a, T>

fn deref_mut(&mut self) -> &mut T

Mutably dereferences the value.

impl<'a, T: ?Sized> Drop for StackPtr<'a, T>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a, T: 'a + Send + ?Sized> Send for StackPtr<'a, T>

impl<'a, T: 'a + Sync + ?Sized> Sync for StackPtr<'a, T>