NAME

allocate_3D_int32_array - (MACRO) Allocates a 3D array of 32 bit integers

SYNOPSIS

#include "l/l_3D_arr.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


kjb_int32 **allocate_3D_int32_array
(
	int num_rows,
	int num_cols
);

DESCRIPTION

This macro expands to a 3D array allocation routine appropriate for 32 bit integers.

RETURNS

On error, this routine returns NULL, with an error message being set. On success it returns a pointer to the array.

WARNING

The structure of the returned array is somewhat different than a more common form of a three-dimensional array in "C" where each block, and each row within each block, is allocated separately. Here the storage area is contiguous. This allows for certain operations to be done quickly, but note the following IMPORTANT point: Blocks and rows cannot be swapped by simply swapping row pointers!

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

allocate_3D_int16_array , free_3D_int16_array , free_3D_int32_array