Struct Box

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

Just a standard Box, more or less. The main difference is that its constructor is fallible instead of panicking.

It probably has fewer features than Rust’s version, but it should be possible to add or emulate those.

Implementations

impl<'a, T> Box<'a, T>

pub fn new(value: T) -> Result<Self, T>

Moves value onto the Pebble heap.

Errors

Iff the heap allocation fails.

pub fn into_inner(box: Self) -> T

Moves r#box’s value off the Pebble heap.

impl<'a> Box<'a, [MaybeUninit<u8>]>

pub fn new_buffer_uninit(len: usize) -> Result<Self, ()>

Errors

Iff not enough heap memory could be allocated.

pub fn assume_init(box: Self) -> Box<'a, [u8]>

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

pub fn leak(box: Self) -> &'a mut T

where T: 'a,

pub unsafe fn from_raw(raw: &'a mut T) -> Self

Reassembles a Box instance from a leaked reference.

Safety

Iff the reference was previously leaked from a matching Box instance.

pub unsafe fn downcast_unchecked<U: Unsize<T>>(box: Self) -> Box<'a, U>

Reinterprets a Box of an type T into its original sized type Box<U>.

Safety

Iff this instance was created from a value memory-compatible to U.

impl Box<'static, CStr<Heap>>

pub fn clone_to_c_str(value: &str) -> Result<Self, ()>

Clones a Rust str onto the Pebble heap, appending '\0' in the process.

Errors

Iff the heap allocation fails.

Trait Implementations

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

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

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

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

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

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> From<Box<'a, CStr<Heap>>> for Box<'a, str>

fn from(value: Box<'a, CStr<Heap>>) -> Self

Converts to this type from the input type.

impl<'a, F: ?Sized + Future + Unpin> Future for Box<'a, F>

type Output = <F as Future>::Output

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.

impl<'a> TryFrom<Box<'a, str>> for Box<'a, CStr<Heap>>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: Box<'_, str>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, T: ?Sized + Unsize<U>, U: ?Sized> CoerceUnsized<Box<'a, U>> for Box<'a, T>

impl<'a, T: ?Sized> Unpin for Box<'a, T>