Bounded And Clamped Value Macros (Useful for guarding against invalid integer ranges)

bounded_and_clamped_value_macro.c

#!/usr/bin/tcc -run

// Bounded Value Macros (Useful for guarding against invalid integer ranges)
#define clamp_upper(value, max) ((value) < (max) ? (value) : (max))
#define clamp_lower(value, min) ((value) > (min) ? (value) : (min))
#define clamp_range(value, min, max) clamp_lower(min, clamp_upper(value, max))

#define is_above_bound(value, max) ((value) > (max))
#define is_below_bound(value, min) ((value) < (min))
#define is_within_bound(value, min, max) ((value) >= (min) && (value) <= (max))
#define is_out_of_bound(value, min, max) ((value) < (min) || (value) > (max))

#include <stdio.h>

int main(void) {
    const int min = -2;
    const int max = 2;

    printf("# Bounded/Clamped Value Macros Outputs");
    printf("\n");
    printf("* min = %d\n", min);
    printf("* max = %d\n", max);

    printf("\n");
    printf("## Clamped Value Macros Outputs\n");
    printf("| i | clamp_upper | clamp_lower | clamp_range |\n");
    printf("|:---:|:---:|:---:|:---:|\n");
    for (int i = -5; i <= 5; i++) 
    {
        printf("| %2d | %2d | %2d | %2d |\n", i, clamp_upper(i, max), clamp_lower(i, min), clamp_range(i, min, max));
    }

    printf("\n");
    printf("## Bounded Value Macros Outputs\n");
    printf("| i | is_below_bound | is_above_bound | is_within_bound | is_out_of_bound |\n");
    printf("|:---:|:---:|:---:|:---:|:---:|\n");
    for (int i = -5; i <= 5; i++) 
    {
        printf("| %2d | %s | %s | %s | %s |\n", i, is_below_bound(i, min) ? "**true**":"false", is_above_bound(i, max) ? "**true**":"false", is_within_bound(i, min, max) ? "**true**":"false", is_out_of_bound(i, min, max) ? "**true**":"false");
    }
}

Bounded/Clamped Value Macros Outputs

• min = -2
• max = 2

Clamped Value Macros Outputs

i	clamp_upper	clamp_lower	clamp_range
-5	-5	-2	-2
-4	-4	-2	-2
-3	-3	-2	-2
-2	-2	-2	-2
-1	-1	-1	-1
0	0	0	0
1	1	1	1
2	2	2	2
3	2	3	2
4	2	4	2
5	2	5	2

Bounded Value Macros Outputs

i	is_below_bound	is_above_bound	is_within_bound	is_out_of_bound
-5	true	false	false	true
-4	true	false	false	true
-3	true	false	false	true
-2	false	false	true	false
-1	false	false	true	false
0	false	false	true	false
1	false	false	true	false
2	false	false	true	false
3	false	true	false	true
4	false	true	false	true
5	false	true	false	true