Struct gharial::MaybeAlloc

pub struct MaybeAlloc<A = TestAlloc<System>>where
    A: GlobalAlloc,{ /* private fields */ }

MaybeAlloc is an implementation for GlobalAlloc , which occasionally fails to allocate.

It is a wrapper of another GlobalAlloc , and delegates the requests to the inner, however, sometimes fails to allocate memory on purpose. i.e. MaybeAlloc::alloc can return null pointer before memory exhaustion.

The failure properbility is 1/16.

Trait Implementations

impl<A> Clone for MaybeAlloc<A>where A: GlobalAlloc + Clone,

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<A> Debug for MaybeAlloc<A>where A: GlobalAlloc + Debug,

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

Formats the value using the given formatter.

impl<A> Default for MaybeAlloc<A>where A: GlobalAlloc + Default,

fn default() -> Self

Returns the “default value” for a type.

impl<A> From<A> for MaybeAlloc<A>where A: GlobalAlloc,

fn from(alloc: A) -> Self

Converts to this type from the input type.

impl<A> GlobalAlloc for MaybeAlloc<A>where A: GlobalAlloc,

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocate memory as described by the given layout.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocate the block of memory at the given ptr pointer with the given layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned.

unsafe fn realloc(&self, ptr: *mut u8, layout: Layout, new_size: usize) -> *mut u8

Shrink or grow a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.