NAME
read_int_matrix - Reads an integer matrix from a file
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
(
Int_matrix **result_mpp,
const char *file_name
);
DESCRIPTION
This routine reads an integer matrix from a file. If the file_name is NULL
or a null string, then stdin is assumed. If this is the case, and if the
source is not a file (i.e. a pipe), then this routine will fail.
Several read strategies are tried until one succeeds. The first strategy is
to assume the file is a matlab integer matrix (see
fp_read_int_matrix_from_matlab_file(3)). The second strategy is to assume
that the file has a header file (see fp_read_int_matrix_with_header(3)).The
final strategy is to assume that the file is a formatted ascii file, and the
matrix dimensions are deduced from the number of rows and columns. The
number of columns in each row must be the same.
The integer matrix *result_mpp is created or resized as necessary.
RETURNS
NO_ERROR on success, and ERROR on failure with an appropriate error
message being set.
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
,
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_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