Struct MemoryPressure 

pub struct MemoryPressure { /* private fields */ }

A memory-pressure guard that holds size_bytes of allocated memory for its entire lifetime.

Drop the guard to release the memory.

Example

use dev_chaos::memory_pressure::MemoryPressure;

{
    let _hold = MemoryPressure::allocate(1_024 * 1_024); // 1 MiB
    // ... run code under memory pressure ...
} // memory released here

Implementations

impl MemoryPressure

pub fn allocate(size_bytes: usize) -> Self

Allocate and hold size_bytes of zeroed memory.

Always succeeds for sizes the allocator can satisfy. Returns the guard; drop it to release the memory.

For testing OOM / allocation-failure paths specifically, see MemoryPressure::try_allocate.

pub fn try_allocate(size_bytes: usize) -> Result<Self, TryReserveError>

Attempt to allocate size_bytes, returning the error path rather than panicking on allocator failure.

This catches try_reserve_exact errors. For genuinely OOM scenarios on most platforms the kernel may kill the process before this returns; honest behavior is platform-specific.

pub fn size_bytes(&self) -> usize

The number of bytes this guard is holding.

pub fn allocate_kib(kib: usize) -> Self

Convenience: allocate kib KiB.

pub fn allocate_mib(mib: usize) -> Self

Convenience: allocate mib MiB.