NAME

read_int_matrix_by_rows - Reads data row-wise from a file into a integer matrix

SYNOPSIS

#include "l/l_int_mat_io.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 read_int_matrix_by_rows
(
	Int_matrix **result_mpp,
	const char *file_name,
	int num_cols
);

DESCRIPTION

This routine reads data contained in a file specified by a file name into an integer matrix whose number of columns is known. Currently there must be exactly one number per line in the file. The integer matrix *result_mpp is created or resized as necessary. "file_name" points to a character array specifying the name of the file to read the data from. If the "file_name" argument is NULL or the first character is null, input is expected from STDIN instead of a file. "num_cols" indicates the number of columns the created matrix will contain. The number of rows in the new matrix depends on the number of data elements in the file.

RETURNS

NO_ERROR on success and ERROR on failure, with an appropriate error message being set.

RELATED

read_int_matrix_by_cols, fp_read_int_matrix_by_rows, kjb_print_error.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Lindsay Martin and Kobus Barnard

SEE ALSO

read_int_matrix_from_config_file , read_int_matrix , fp_read_int_matrix , fp_read_raw_int_matrix , fp_read_int_matrix_from_matlab_file , fp_read_int_matrix_with_header , fp_read_formatted_int_matrix , fp_read_int_matrix_by_rows , read_int_matrix_by_cols , fp_read_int_matrix_by_cols , fp_ow_read_formatted_int_matrix , fp_ow_read_int_matrix_by_rows , fp_ow_read_int_matrix_by_cols , fp_read_matrix_size_header , fp_write_int_matrix_with_title , write_int_matrix , fp_write_int_matrix , write_raw_int_matrix , fp_write_raw_int_matrix , write_int_matrix_rows , fp_write_int_matrix_rows , write_int_matrix_cols , fp_write_int_matrix_cols , write_int_matrix_with_header , fp_write_int_matrix_with_header , fp_write_matrix_size_header , write_int_matrix_to_matlab_file , fp_write_int_matrix_to_matlab_file