Struct gharial::MaybeAlloc

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

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> Debug for MaybeAlloc<A> where
    A: GlobalAlloc, 

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

Performs the conversion.

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. The block is described by the given ptr pointer and layout.