Struct ChaosAllocator 

pub struct ChaosAllocator<A = System> { /* private fields */ }

A global allocator wrapper that can deterministically fail selected allocation attempts during an alloc_chaos check.

Install it once in a test binary:

#[global_allocator]
static GLOBAL: alloc_chaos::ChaosAllocator = alloc_chaos::ChaosAllocator::system();

The wrapper delegates to its inner allocator unless a check is active and the current allocation attempt is the selected failure target.

Implementations

impl ChaosAllocator<System>

pub const fn system() -> Self

Creates a wrapper around std::alloc::System.

Examples found in repository

examples/scenarios.rs (line 16)

static GLOBAL: alloc_chaos::ChaosAllocator = alloc_chaos::ChaosAllocator::system();

examples/try_reserve.rs (line 10)

static GLOBAL: alloc_chaos::ChaosAllocator = alloc_chaos::ChaosAllocator::system();

impl<A> ChaosAllocator<A>

pub const fn new(inner: A) -> Self

Creates a wrapper around a custom global allocator.

Trait Implementations

impl<A> Debug for ChaosAllocator<A>

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

Formats the value using the given formatter.

impl<A> GlobalAlloc for ChaosAllocator<A>

where A: GlobalAlloc,

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

Allocates memory as described by 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 dealloc(&self, ptr: *mut u8, layout: Layout)

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

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

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