NAME

get_target_v4 - Gets a target vector vector vector

SYNOPSIS

#include "m/m_vector.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 get_target_v4
(
	V_v_v_v **target_vvvvpp,
	int length
);

DESCRIPTION

This routine implements the creation/over-writing semantics used in the KJB library in the case of vector vector vectors. If *target_vvvvpp is NULL, then this routine creates the vector vector vector. If it is not null, and it is the right size, then this routine does nothing. If it is the wrong size, then it is 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 the array.

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

get_unity_vector , get_zero_vector , get_initialized_vector , get_target_vector , free_vector , get_random_vector , get_random_vector_2 , get_random_unit_vector , vp_get_indexed_vector , get_zero_indexed_vector , get_random_indexed_vector , get_target_indexed_vector , free_indexed_vector , ascend_sort_indexed_vector , descend_sort_indexed_vector , get_target_vector_vector , free_vector_vector , allocate_2D_vp_array , free_2D_vp_array_and_vectors , get_target_v3 , free_v3 , free_v4