NAME

fp_ow_read_int_matrix_by_rows - Reads data row-wise from a file into an existing 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 fp_ow_read_int_matrix_by_rows
(
	Int_matrix *mp,
	FILE *fp
);

DESCRIPTION

This routine reads an integer matrix from a file as specified by a file pointer into a matrix. The matrix must already exist. Currently there must be exactly one number per line in the file. "mp" is a pointer to a Int_matrix object. This matrix must already exist, and have the predefined size 'mp->num_rows' X 'mp->num_cols'. "fp" points to a FILE structure associated with the input stream as returned by "kjb_fopen".

RETURNS

ERROR, if "mp" is NULL, if EOF is encountered before num_rows X num_cols elements have been read, or if an error occurs reading a floating point number. EOF, if the contents of the file is empty. NO_ERROR on success.

RELATED

read_and create_int_matrix_bu_rows, fp_ow_read_int_matrix_by_cols

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 , read_int_matrix_by_rows , 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_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