NAME

ra_get_target_int_vector - Gets a target integer vector

SYNOPSIS

#include "l/l_int_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 ra_get_target_int_vector
(
	Int_vector **target_vpp,
	int length
);

DESCRIPTION

This routine is similar to get_target_int_vector(), except that reallocation is used when appropriate, via kjb_realloc(). This means that an existing vector argument size is increased without disturbing existing elements. Also different than get_target_int_vector(), if the vector size is being decreased, then the amount of storage is decreased. By contrast, get_target_int_vector() shrinks a vector by simply changing the "length" field. The behaviour of get_target_int_vector() is more efficient, but it can lead to using more memory than needed. Since it is sometimes helfpul to be able to trim the memory to the minimum needed, we implement this different behavior as part of this function.

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_zero_int_vector , get_unity_int_vector , get_initialized_int_vector , create_int_vector , free_int_vector , vp_get_indexed_int_vector , get_zero_indexed_int_vector , get_target_indexed_int_vector , add_int_vectors , subtract_int_vectors , ow_add_int_vectors , ow_subtract_int_vectors , get_random_index_vector , split_int_vector_vector , split_int_vector , copy_int_vector_vector , copy_int_vector , copy_int_vector_section , read_int_vector , fp_read_int_vector , fp_read_raw_int_vector , fp_read_int_vector_with_header , fp_read_ascii_int_vector , fp_read_vector_length_header , write_col_int_vector , fp_write_col_int_vector , fp_write_col_int_vector_with_title , write_col_int_vector_with_header , fp_write_col_int_vector_with_header , write_row_int_vector , fp_write_row_int_vector , fp_write_row_int_vector_with_title , fp_write_vector_length_header , write_raw_int_vector , fp_write_raw_int_vector , get_target_int_vector_vector , free_int_vector_vector , get_target_int_v3 , free_int_v3 , int_vector_binary_search , int_vector_linear_search , sum_int_vector_elements , read_int_vector_vector , fp_read_int_vector_vector , fp_read_raw_int_vector_vector , fp_read_formatted_int_vector_vector , write_int_vector_vector , fp_write_int_vector_vector , write_raw_int_vector_vector , fp_write_raw_int_vector_vector , fp_write_raw_int_vector_vector_header , sget_int_vector , sget_positive_int_vector , sget_non_negative_int_vector , ow_copy_int_vector , min_int_vector_element , max_int_vector_element , get_max_int_vector_element , get_min_int_vector_element , multiply_int_vector_by_int_scalar , ow_multiply_int_vector_by_int_scalar , add_int_scalar_to_int_vector , int_set_difference , is_element_in_int_vector , get_int_dot_product , int_vector_magnitude , sum_int_vector_squared_elements , check_same_int_vector_lengths , max_abs_int_vector_difference , int_vector_is_permutation , get_string_why_int_vector_is_not_permutation