NAME

copy_vector_segment - Copies part of a 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_vector_segment
(
	Vector **target_vpp,
	const Vector *source_vp,
	int start_index,
	int length
);

DESCRIPTION

This routine copies part of the vector pointed to by source_vp to the vector pointer to by *target_vp. If *target_vp is NULL, then it is created. If it is the wrong size, it is resized. The copying begins at start_index, and goes on for the specified length.

RETURNS

On success, this routine returns a pointer to a newly created vector which is a copy of the input vector. On failure, it returns NULL, and sets an error message. This routine can fail if storage allocation fails, if start_index is negative, if length is negative, or if the quantity (start_index + length) exceeds the length of the source_vp vector.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER