SAF
Loading...
Searching...
No Matches
md_malloc.c File Reference

Contiguous memory allocation functions for multi-dimensional arrays. More...

#include <stdio.h>
#include <math.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include "md_malloc.h"

Go to the source code of this file.

Macros

#define MIN(a, b)   (( (a) < (b) ) ? (a) : (b))
 
#define MAX(a, b)   (( (a) > (b) ) ? (a) : (b))
 

Functions

void * malloc1d (size_t dim1_data_size)
 1-D malloc (same as malloc, but with error checking)
 
void * calloc1d (size_t dim1, size_t data_size)
 1-D calloc (same as calloc, but with error checking)
 
void * realloc1d (void *ptr, size_t dim1_data_size)
 1-D realloc (same as realloc, but with error checking)
 
void ** malloc2d (size_t dim1, size_t dim2, size_t data_size)
 2-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void ** calloc2d (size_t dim1, size_t dim2, size_t data_size)
 2-D calloc (contiguously allocated, so use free() as usual to deallocate)
 
void ** realloc2d (void **ptr, size_t dim1, size_t dim2, size_t data_size)
 2-D realloc which does NOT retain previous data order
 
void ** realloc2d_r (void **ptr, size_t new_dim1, size_t new_dim2, size_t prev_dim1, size_t prev_dim2, size_t data_size)
 2-D realloc which does retain previous data order
 
void *** malloc3d (size_t dim1, size_t dim2, size_t dim3, size_t data_size)
 3-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void *** calloc3d (size_t dim1, size_t dim2, size_t dim3, size_t data_size)
 3-D calloc (contiguously allocated, so use free() as usual to deallocate)
 
void *** realloc3d (void ***ptr, size_t new_dim1, size_t new_dim2, size_t new_dim3, size_t data_size)
 3-D realloc which does NOT retain previous data order
 
void *** realloc3d_r (void ***ptr, size_t new_dim1, size_t new_dim2, size_t new_dim3, size_t prev_dim1, size_t prev_dim2, size_t prev_dim3, size_t data_size)
 3-D realloc which does retain previous data order
 
void **** malloc4d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t data_size)
 4-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void **** calloc4d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t data_size)
 4-D calloc (contiguously allocated, so use free() as usual to deallocate)
 
void **** realloc4d (void ****ptr, size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t data_size)
 4-D realloc which does NOT retain previous data order
 
void ***** malloc5d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t data_size)
 5-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void ***** calloc5d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t data_size)
 5-D calloc (contiguously allocated, so use free() as usual to deallocate)
 
void ***** realloc5d (void *****ptr, size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t data_size)
 5-D realloc which does NOT retain previous data order
 
void ****** malloc6d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t dim6, size_t data_size)
 6-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void ****** calloc6d (size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t dim6, size_t data_size)
 6-D malloc (contiguously allocated, so use free() as usual to deallocate)
 
void ****** realloc6d (void ******ptr, size_t dim1, size_t dim2, size_t dim3, size_t dim4, size_t dim5, size_t dim6, size_t data_size)
 6-D realloc which does NOT retain previous data order
 

Detailed Description

Contiguous memory allocation functions for multi-dimensional arrays.

Adapted from: https://github.com/leomccormack/md_malloc

An example of allocating, indexing and freeing a 3-D "array":

float*** example3D = (float***)malloc3d(10, 20, 5, sizeof(float);
// Due to the contiguous nature of the allocation, this is possible:
memset(FLATTEN3D(example3D), 0, 10*20*5*sizeof(float));
// And may still be indexed normally as:
example3D[3][19][2] = 22.0f;
// To free, simply call:
free(example3D);
void *** malloc3d(size_t dim1, size_t dim2, size_t dim3, size_t data_size)
3-D malloc (contiguously allocated, so use free() as usual to deallocate)
Definition md_malloc.c:151
#define FLATTEN3D(A)
Use this macro when passing a 3-D dynamic multi-dimensional array to memset, memcpy or any other func...
Definition md_malloc.h:72
Author
Leo McCormack
Date
11.06.2019
License
MIT

Definition in file md_malloc.c.

Macro Definition Documentation

◆ MAX

#define MAX ( a,
b )   (( (a) > (b) ) ? (a) : (b))

Definition at line 56 of file md_malloc.c.

◆ MIN

#define MIN ( a,
b )   (( (a) < (b) ) ? (a) : (b))

Definition at line 53 of file md_malloc.c.

Function Documentation

◆ calloc1d()

void * calloc1d ( size_t dim1,
size_t data_size )

1-D calloc (same as calloc, but with error checking)

Definition at line 69 of file md_malloc.c.

◆ calloc2d()

void ** calloc2d ( size_t dim1,
size_t dim2,
size_t data_size )

2-D calloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 102 of file md_malloc.c.

◆ calloc3d()

void *** calloc3d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t data_size )

3-D calloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 170 of file md_malloc.c.

◆ calloc4d()

void **** calloc4d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t data_size )

4-D calloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 264 of file md_malloc.c.

◆ calloc5d()

void ***** calloc5d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t data_size )

5-D calloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 349 of file md_malloc.c.

◆ calloc6d()

void ****** calloc6d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t dim6,
size_t data_size )

6-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 460 of file md_malloc.c.

◆ malloc1d()

void * malloc1d ( size_t dim1_data_size)

1-D malloc (same as malloc, but with error checking)

Definition at line 59 of file md_malloc.c.

◆ malloc2d()

void ** malloc2d ( size_t dim1,
size_t dim2,
size_t data_size )

2-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 89 of file md_malloc.c.

◆ malloc3d()

void *** malloc3d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t data_size )

3-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 151 of file md_malloc.c.

◆ malloc4d()

void **** malloc4d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t data_size )

4-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 238 of file md_malloc.c.

◆ malloc5d()

void ***** malloc5d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t data_size )

5-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 315 of file md_malloc.c.

◆ malloc6d()

void ****** malloc6d ( size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t dim6,
size_t data_size )

6-D malloc (contiguously allocated, so use free() as usual to deallocate)

Definition at line 416 of file md_malloc.c.

◆ realloc1d()

void * realloc1d ( void * ptr,
size_t dim1_data_size )

1-D realloc (same as realloc, but with error checking)

Definition at line 79 of file md_malloc.c.

◆ realloc2d()

void ** realloc2d ( void ** ptr,
size_t dim1,
size_t dim2,
size_t data_size )

2-D realloc which does NOT retain previous data order

Definition at line 115 of file md_malloc.c.

◆ realloc2d_r()

void ** realloc2d_r ( void ** ptr,
size_t new_dim1,
size_t new_dim2,
size_t prev_dim1,
size_t prev_dim2,
size_t data_size )

2-D realloc which does retain previous data order

Test
test__realloc2d_r()

Definition at line 127 of file md_malloc.c.

◆ realloc3d()

void *** realloc3d ( void *** ptr,
size_t new_dim1,
size_t new_dim2,
size_t new_dim3,
size_t data_size )

3-D realloc which does NOT retain previous data order

Definition at line 189 of file md_malloc.c.

◆ realloc3d_r()

void *** realloc3d_r ( void *** ptr,
size_t new_dim1,
size_t new_dim2,
size_t new_dim3,
size_t prev_dim1,
size_t prev_dim2,
size_t prev_dim3,
size_t data_size )

3-D realloc which does retain previous data order

Definition at line 207 of file md_malloc.c.

◆ realloc4d()

void **** realloc4d ( void **** ptr,
size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t data_size )

4-D realloc which does NOT retain previous data order

Definition at line 290 of file md_malloc.c.

◆ realloc5d()

void ***** realloc5d ( void ***** ptr,
size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t data_size )

5-D realloc which does NOT retain previous data order

Definition at line 383 of file md_malloc.c.

◆ realloc6d()

void ****** realloc6d ( void ****** ptr,
size_t dim1,
size_t dim2,
size_t dim3,
size_t dim4,
size_t dim5,
size_t dim6,
size_t data_size )

6-D realloc which does NOT retain previous data order

Definition at line 504 of file md_malloc.c.