NAME

split_v4 - Splits a target vector vector vector vector

SYNOPSIS

#include "m/m_vec_basic.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 split_v4
(
	V_v_v_v **target_1_vvvvpp,
	V_v_v_v **target_2_vvvvpp,
	const V_v_v_v *source_vvvvp,
	const Int_vector *index_list_vp
);

DESCRIPTION

This routine splits a vector vector vector vector with the creation/over-writing semantics used in the KJB library in the case of vector vector vectors according to a list provided in index_list_vp. If *target_1_vvvvpp or *target_2_vvvvpp is NULL, then this routine creates the vector vector. If they are not null, and are the right size, then the storage is recycled. If they are the wrong size, then they are resized. The routine free_v4 should be used to dispose of the storage once it is no longer needed.

RETURNS

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

DISCLAIMER

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

AUTHOR

Ranjini Swaminathan

DOCUMENTER