# 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