std.experimental.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.

Source: std/experimental/allocator/_showcase.d

alias StackFront

fn mmapRegionList

Types 1

aliasStackFront(size_t stackSize, Allocator = GCAllocator) = FallbackAllocator!( InSituRegion!(stackSize, Allocator.alignment), Allocator)

Allocator that uses stack allocation for up to stackSize bytes and then falls back to Allocator. Defined as:

---- alias StackFront(size_t stackSize, Allocator) = FallbackAllocator!( InSituRegion!(stackSize, Allocator.alignment, hasMember!(Allocator, "deallocate") ? Yes.defineDeallocate : No.defineDeallocate), Allocator); ----

Choosing stackSize 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.

Functions 1

fnauto mmapRegionList(size_t bytesPerRegion)Creates a scalable `AllocatorList` of `Regions`, each having at least `bytesPerRegion` bytes. Allocation is very fast. This allocator does not offer `deallocate` but does free all regions in its de...