AlignedMallocator

Aligned allocator using OS-specific primitives, under a uniform API.

Members

Functions

alignedAllocate
void[] alignedAllocate(size_t bytes, uint a)

Uses posix_memalign on Posix and __aligned_malloc on Windows.

alignedReallocate
bool alignedReallocate(void[] b, size_t s, uint a)

On Posix there is no realloc for aligned memory, so alignedReallocate emulates the needed behavior by using alignedAllocate to get a new block. The existing block is copied to the new block and then freed. On Windows, calls __aligned_realloc(b.ptr, newSize, a).

allocate
void[] allocate(size_t bytes)

Forwards to alignedAllocate(bytes, platformAlignment).

deallocate
bool deallocate(void[] b)

Calls free(b.ptr) on Posix and __aligned_free(b.ptr) on Windows.

reallocate
bool reallocate(void[] b, size_t newSize)

Forwards to alignedReallocate(b, newSize, platformAlignment). Should be used with blocks obtained with allocate otherwise the custom alignment passed with alignedAllocate can be lost.

Static variables

instance
AlignedMallocator instance;

Returns the global instance of this allocator type. The C heap allocator is thread-safe, therefore all of its methods and instance itself are shared.

Variables

alignment
enum uint alignment;

The default alignment is platformAlignment.

Examples

auto buffer = AlignedMallocator.instance.alignedAllocate(1024 * 1024 * 4,
    128);
scope(exit) AlignedMallocator.instance.deallocate(buffer);
//...

Meta