NAME

allocate_2D_int16_array - (MACRO) Allocates a 2D array of 16 bit integers

SYNOPSIS

#include "l/l_2D_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_int16 **allocate_2D_int16_array
(
	int num_rows,
	int num_cols
);

DESCRIPTION

This macro expands to a 2D array allocation routine appropriate for 16 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 two-dimensional array in "C" where each row is allocated separately. Here the storage area is contiguous. This allows for certain operations to be done quickly, but note the following IMPORTANT point: num_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