Function scratchstack_wrapper_aws_c_common::aws_mem_acquire_many

pub unsafe extern "C" fn aws_mem_acquire_many(
    allocator: *mut aws_allocator,
    count: usize,
     ...
) -> *mut c_void

Allocates many chunks of bytes into a single block. Expects to be called with alternating void ** (dest), size_t (size). The first void ** will be set to the root of the allocation. Alignment is assumed to be sizeof(intmax_t).

This is useful for allocating structs using the pimpl pattern, as you may allocate the public object and impl object in the same contiguous block of memory.

Returns a pointer to the allocation.

In versions v0.6.8 and prior, this function was allowed to return NULL. In later versions, if allocator->mem_acquire() returns NULL, this function will assert and exit. To handle conditions where OOM is not a fatal error, allocator->mem_acquire() is responsible for finding/reclaiming/running a GC etc…before returning.