Ergonomic Allocation Macros

Dylan Falconer-style typed allocation macros. No casts, no sizeof. More...

Macros
#define	MAKE(type, count, alloc)
	Allocates and zero-initialises an array of count elements of type.
#define	MAKE_STRUCT(type, alloc)
	Allocates and zero-initialises a single instance of type.
#define	RELEASE(type, count, ptr, alloc)
	Frees a previously allocated block through the allocator.

Detailed Description

Dylan Falconer-style typed allocation macros. No casts, no sizeof.

Macro Definition Documentation

MAKE

#define MAKE	(		type,
			count,
			alloc )

Value:

((type *)mem_alloc((alloc), sizeof(type) * (count)))

Allocates and zero-initialises an array of count elements of type.

Example:

MemAllocator a = mem_allocator_create(ARENA, GB(1));
MyStruct *nodes = MAKE(MyStruct, 64, &a);

Parameters

type	The element type.
count	Number of elements.
alloc	Pointer to a MemAllocator.

Returns

Correctly typed pointer to the zeroed allocation, or NULL on OOM.

Definition at line 208 of file mem_allocator.h.

MAKE_STRUCT

#define MAKE_STRUCT	(		type,
			alloc )

Value:

((type *)mem_alloc((alloc), sizeof(type)))

Allocates and zero-initialises a single instance of type.

Example:

Node *n = MAKE_STRUCT(Node, &a);
n->value = 42;

Parameters

type	The struct type to allocate.
alloc	Pointer to a MemAllocator.

Returns

Correctly typed pointer to the zeroed struct, or NULL on OOM.

Definition at line 223 of file mem_allocator.h.

RELEASE

#define RELEASE	(		type,
			count,
			ptr,
			alloc )

Value:

mem_free((alloc), (ptr), sizeof(type) * (count))

Frees a previously allocated block through the allocator.

For arena allocators this is a no-op. For heap allocators it calls free.

Parameters

type	The element type (used to compute the size).
count	Number of elements originally allocated.
ptr	Pointer to the allocation.
alloc	Pointer to the MemAllocator.

Definition at line 235 of file mem_allocator.h.