stdx.allocator.showcase
Collection of typical and useful prebuilt allocators using the given components. User code would typically import this module and use its facilities, or import individual heap building blocks and assemble them.
-
Declaration
template
StackFront
(size_t stackSize, Allocator = GCAllocator)Allocator that uses stack allocation for up to bytes and then falls back to . Defined as:
Discussion
alias StackFront(size_t stackSize, Allocator) = FallbackAllocator!( InSituRegion!(stackSize, Allocator.alignment, hasMember!(Allocator, "deallocate") ? Yes.defineDeallocate : No.defineDeallocate), Allocator);
ChoosingstackSize
is as always a compromise. Too small a size exhausts the stack storage after a few allocations, after which there are no gains over the backup allocator. Too large a size increases the stack consumed by the thread and may end up worse off because it explores cold portions of the stack.Examples
StackFront!4096 a; auto b = a.allocate(4000); assert(b.length == 4000); auto c = a.allocate(4000); assert(c.length == 4000); a.deallocate(b); a.deallocate(c);
-
Declaration
auto
mmapRegionList
(size_tbytesPerRegion
);Creates a scalable
AllocatorList
ofRegions
, each having at least
bytes. Allocation is very fast. This allocator does not offerbytesPerRegion
deallocate
but does free all regions in its destructor. It is recommended for short-lived batch applications that count on never running out of memory.Examples
auto alloc = mmapRegionList(1024 * 1024); const b = alloc.allocate(100); assert(b.length == 100);