NAME
read_vector_vector - Reads a vector vector from file
SYNOPSIS
#include "m/m_vec_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_vector_vector
(
Vector_vector **result_vvpp,
const char *file_name
);
DESCRIPTION
This routine reads a vector vector 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.
In theory, and in parallel with other routines such as read_matrix, several
read strategies are tried until one succeeds. However, only one strategy is
currently implemented. Specifically we assume that
the file is a formatted ascii file, and the vector vector dimensions are
deduced from the number of rows and columns (see also
fp_read_formatted_vector_vector(3)).
The vector vector *result_vvpp 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 retrieved from STDIN. If STDIN is
not a redirected file, an error message will be generated.
RETURNS
Either NO_ERROR, or ERROR, 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_vector_from_config_file
,
read_vector
,
fp_read_vector
,
fp_read_raw_vector
,
fp_read_vector_with_header
,
fp_read_ascii_vector
,
fp_ow_read_vector
,
write_row_vector
,
fp_write_row_vector
,
write_indexed_vector
,
fp_write_indexed_vector
,
write_col_vector
,
fp_write_col_vector
,
write_col_vector_with_header
,
fp_write_col_vector_with_header
,
write_raw_vector
,
fp_write_raw_vector
,
write_row_vector_full_precision
,
fp_write_row_vector_full_precision
,
write_col_vector_full_precision
,
fp_write_col_vector_full_precision
,
read_vector_vector_from_config_file
,
fp_read_vector_vector
,
fp_read_raw_vector_vector
,
fp_read_formatted_vector_vector
,
fp_write_vector_vector_with_title
,
write_vector_vector
,
fp_write_vector_vector
,
write_raw_vector_vector
,
fp_write_raw_vector_vector
,
fp_write_raw_vector_vector_header
,
write_vector_vector_full_precision
,
fp_write_vector_vector_full_precision