NAME

get_target_int_matrix - Gets target Int_matrix

SYNOPSIS

#include "l/l_int_matrix.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


int get_target_int_matrix
(
	Int_matrix **target_mpp,
	int num_rows,
	int num_cols
);

DESCRIPTION

This routine implements the creation/over-writing semantics used in the KJB library in the case of integer matrices. If *target_mpp is NULL, then this routine creates the int_matrix. 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. In order to be memory efficient, we free before resizing. If the resizing fails, then the original contents of the *target_mpp will be lost. However, target_mpp->elements will be set to NULL, so *target_mpp can be safely sent to free_matrix().

SEEALSO

Int_matrix

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTOR

Kobus Barnard

SEE ALSO

same_int_matrix_dimensions , get_zero_int_matrix , get_initialized_int_matrix , ra_get_target_int_matrix , free_int_matrix , ow_zero_int_matrix , ow_set_int_matrix , ra_get_target_int_matrix_vector , get_target_int_matrix_vector , free_int_matrix_vector , get_target_int_vector_matrix , free_int_vector_matrix , concat_int_matrices_vertically , copy_int_matrix , ow_copy_int_matrix , copy_int_matrix_block , ow_copy_int_matrix_block , copy_int_matrix_row , copy_int_matrix_col , get_int_matrix_row , get_int_matrix_col , put_int_matrix_row , put_int_matrix_col , get_int_transpose , swap_int_matrix_rows , max_abs_int_matrix_difference , check_same_int_matrix_dimensions , sum_int_matrix_elements , sum_int_matrix_rows , ow_sum_int_matrix_rows , ow_add_col_int_vector_to_int_matrix , ow_add_row_int_vector_to_int_matrix , ow_add_int_scalar_to_int_matrix , ow_multiply_int_matrix_by_int_scalar , add_int_matrices , ow_add_int_matrices