NAME

concat_int_matrices_vertically - Concatenates integer matrices verically

SYNOPSIS

#include "l/l_int_matrix.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 


int concat_int_matrices_vertically
(
	Int_matrix **mpp,
	int num_int_matrices,
	const Int_matrix **int_matrix_list
);

DESCRIPTION

This routine takes an array of integer matrices and forms one int_matrix consisting of those integer matrices stacked on top of each other. The first argument is the adress of the target int_matrix. If the target int_matrix itself is null, then a int_matrix of the appropriate size is created. If the target int_matrix is the wrong size, it is resized. Finally, if it is the right size, then the storage is recycled, as is. The int_matrix array may contain any number of NULL integer matrices. If there are only NULL integer matrices, or if num_integer_matrices is zero, then the target int_matrix is freed and set to NULL.

RETURNS

NO_ERROR on success and ERROR on failure This routine will only fail if storage allocation fails.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER