NAME

copy_v3 - Copies a target 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 copy_v3
(
	V_v_v **target_vvvpp,
	const V_v_v *source_vvvp
);

DESCRIPTION

This routine copies a vector vector vector with the creation/over-writing semantics used in the KJB library in the case of vector vector vectors. If *target_vvvpp is NULL, then this routine creates the vector vector. If it is not null, and it is the right size, then the storage is recycled. If it is the wrong size, then it is resized. The routine free_v3 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

split_v4 , split_vector_vector , split_vector , copy_v4 , copy_indexed_vector , create_vector_copy , select_from_vector_vector , copy_vector_vector , copy_vector_segment , copy_vector , ow_copy_vector , flatten_vector_vector , vector_vector_from_vector , vector_vector_from_matrix , get_vector_vector_transpose , is_element_in_vector , is_vector_vector_consistent