Utility Math & Helpers

Quality-of-life macros for strings, pointers, and math. More...

Macros
#define	STRINGIFY_DETAIL(x)
	Internal implementation of STRINGIFY. Do not use directly.
#define	STRINGIFY(x)
	Safely converts a macro argument into a string literal.
#define	GLUE_DETAIL(x, y)
	Internal implementation of GLUE. Do not use directly.
#define	GLUE(x, y)
	Safely concatenates two tokens together into a single token.
#define	INT_FROM_PTR(ptr)
	Safely casts a pointer to an integer of pointer size.
#define	PTR_FROM_INT(type, val)
	Safely casts a pointer-sized integer back to a specific pointer type.
#define	ARRAY_SIZE(arr)
	Calculates the number of elements in a statically allocated array.
#define	MIN(a, b)
	Returns the minimum of two values (Standard C fallback).
#define	MAX(a, b)
	Returns the maximum of two values (Standard C fallback).
#define	CLAMP(val, min, max)
	Clamps a value between a minimum and a maximum (Standard C fallback).
#define	SWAP(type, a, b)
	Generic variable swap.

Detailed Description

Quality-of-life macros for strings, pointers, and math.

Note

Uses type-safe GCC/Clang extensions when available to prevent multiple-evaluation bugs.

Macro Definition Documentation

ARRAY_SIZE

#define ARRAY_SIZE

(

arr

)

Value:

(sizeof(arr) / sizeof((arr)[0]))

Calculates the number of elements in a statically allocated array.

Warning

Do not pass a decayed pointer to this macro. It only works on real arrays.

Parameters

arr	The static array.

Returns

The element count as a size_t.

Definition at line 254 of file base_macros.h.

CLAMP

#define CLAMP	(		val,
			min,
			max )

Value:

(((val) < (min)) ? (min) : ((val) > (max)) ? (max) : (val))

Clamps a value between a minimum and a maximum (Standard C fallback).

Definition at line 303 of file base_macros.h.

GLUE

#define GLUE	(		x,
			y )

Value:

GLUE_DETAIL(x, y)

Safely concatenates two tokens together into a single token.

Parameters

x	The first token.
y	The second token.

Definition at line 231 of file base_macros.h.

GLUE_DETAIL

#define GLUE_DETAIL	(		x,
			y )

Value:

x##y

Internal implementation of GLUE. Do not use directly.

Definition at line 225 of file base_macros.h.

INT_FROM_PTR

#define INT_FROM_PTR

(

ptr

)

Value:

((uintptr_t)(ptr))

Safely casts a pointer to an integer of pointer size.

Parameters

ptr	The pointer to cast.

Returns

An unsigned integer representing the memory address.

Definition at line 238 of file base_macros.h.

MAX

#define MAX	(		a,
			b )

Value:

(((a) > (b)) ? (a) : (b))

Returns the maximum of two values (Standard C fallback).

Definition at line 301 of file base_macros.h.

MIN

#define MIN	(		a,
			b )

Value:

(((a) < (b)) ? (a) : (b))

Returns the minimum of two values (Standard C fallback).

Definition at line 299 of file base_macros.h.

PTR_FROM_INT

#define PTR_FROM_INT	(		type,
			val )

Value:

((type *)(uintptr_t)(val))

Safely casts a pointer-sized integer back to a specific pointer type.

Parameters

type	The type of pointer to return (e.g., int, struct Node).
val	The integer memory address.

Returns

A casted pointer.

Definition at line 246 of file base_macros.h.

STRINGIFY

#define STRINGIFY

(

x

)

Value:

STRINGIFY_DETAIL(x)

Safely converts a macro argument into a string literal.

Parameters

x	The token to stringify. If it is a macro, it will be expanded first.

Returns

A string literal of the evaluated token.

Definition at line 222 of file base_macros.h.

STRINGIFY_DETAIL

#define STRINGIFY_DETAIL

(

x

)

Value:

#x

Internal implementation of STRINGIFY. Do not use directly.

Definition at line 216 of file base_macros.h.

SWAP

#define SWAP	(		type,
			a,
			b )

Value:

do {                                                                                       \
    type _tmp = (a);                                                                   \
    (a)   = (b);                                                                   \
    (b)   = _tmp;                                                                  \
} while (0)

Generic variable swap.

Parameters

type	The data type of the variables being swapped (e.g., int, float).
a	The first variable.
b	The second variable.

Definition at line 312 of file base_macros.h.