Struct gharial::TestAlloc

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

TestAlloc is a implementation for GlobalAlloc to test memory leak and so on.

It is a wrapper of another GlobalAlloc, and checks the requests delegating to the backend allocator.

The checks are followings.

• The argument *mut u8 passed to dealloc is not null. (GlobalAlloc interface does not define the behavior.)
• The consistency of the argument Layout. i.e. the argument passed to dealloc must matche to that passed to alloc to return the corresponding pointer.
• All allocated memories have already been deallocated on the drop. (Note that cloned instances share the allocating memory information. The check is done when the last cloned instance is dropped.)

See also GAlloc . It is an alias to TestAlloc<std::alloc::System> .

Implementations

impl<A> TestAlloc<A>where A: GlobalAlloc,

pub fn providing_pointers(&self) -> Vec<(*mut u8, Layout)>

Returns the list of pointers and layouts that were allocated and not deallocated. The returned value is sorted by the pointer.

Trait Implementations

impl<A> Clone for TestAlloc<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 TestAlloc<A>where A: GlobalAlloc + Debug,

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

impl<A> Drop for TestAlloc<A>where A: GlobalAlloc,

fn drop(&mut self)

Executes the destructor for this type.

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

fn from(inner: A) -> Self

Converts to this type from the input type.

impl<A> GlobalAlloc for TestAlloc<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.

impl<A> Send for TestAlloc<A>where A: GlobalAlloc + Send,

impl<A> Sync for TestAlloc<A>where A: GlobalAlloc + Send + Sync,