Madagascar Programming Reference Manual

4.1. CONVENIENCE ALLOCATION PROGRAMS (ALLOC.C) 51
n2
number of elements in the slower dimension (size t).
Output
ptr
a void pointer pointing to the allocated block of memory.
4.1.26 sf uncharalloc3
Allocates a 3D array in the memory for the float type. It works just like sf uncharalloc2
but does it for three dimensions. This is done by extending the same argument as for
sf uncharalloc2 but this time making a pointer such that Pointer2 -> Pointer1 ->
Pointer. n1 is the fastest dimension.
Call
ptr = sf_ucharalloc3 (n1, n2, n3);
Definition
unsigned char ***sf_ucharalloc3 (size_t n1 /* fast dimension */,
size_t n2 /* slower dimension */,
size_t n3 /* slowest dimension */)
/*< unsigned char 3-D allocation, out[0][0] points to a contiguous array >*/
{
...
}
Input parameters
n1
n2
n3
number of elements in the fastest dimension (size t).
number of elements in the slower dimension (size t).
number of elements in the slower dimension (size t).
Output
ptr
a void pointer pointing to the allocated block of memory.